home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / pctalkc.arc / PC-TALKC.DOC next >
Text File  |  1985-11-05  |  111KB  |  3,103 lines
  1.  
  2.  
  3.  
  4.    PLEASE NOTE:
  5.  
  6.    This documentation covers a greatly enhanced version of PC-TALK III.  The 
  7.    program has been licensed for posting on the CompuServe IBMPC SIG, by 
  8.    express written permission of The Headlands Press, Inc.  It may be freely 
  9.    copied and distributed according to the terms of license given below.
  10.  
  11.                                                tm
  12.                          ===== F R E E W A R E    =====
  13.                            User-Supported Software
  14.      =======================================================================
  15.      |      If you have received this program from another user and        |
  16.      |    find it of value, your $35 contribution will be appreciated.     |
  17.      |                                                                     |
  18.      |                         === FREEWARE ===                            |
  19.      |                           P.O. Box 862                              |
  20.      |                         Tiburon, CA 94920                           |
  21.      |                                                                     |
  22.      | You are encouraged to copy this program as described below.         |
  23.      |                                                                     |
  24.      | ***NOTICE: Users of this program are granted a limited license to   |
  25.      |    make copies for trial use by others on a private, non-commercial |
  26.      |    basis.  This license does not include distribution:              |
  27.      |                                                                     |
  28.      | 1. In connection with any other product or service;                 |
  29.      | 2. For general use within a company or institution;                 |
  30.      | 3. For any consideration or 'disk fee'; or                          |
  31.      | 4. Distribution in modified form... Please cooperate.               |
  32.      |                                                                     |
  33.      | Copyright 1984, 1985 The Headlands Press, Inc.                      |
  34.      =======================================================================
  35.  
  36.    It is the first and the only version to date that has been awarded this 
  37.    privilege by Andrew Fleugelman and The Headlands Press, Inc., to whom I 
  38.    express my gratitude.
  39.  
  40.    Due to its size, there are considerable difficulties involved in 
  41.    producing an executable file, therefore only the executable program is 
  42.    supplied and the basic source code is not included.
  43.  
  44.    The updates provided in this version are so ramified and extensive that 
  45.    exhaustive testing is simply not possible for me to do in a free program 
  46.    environment.
  47.  
  48.    Extensive testing has been done, by experienced beta testers, 3 of 
  49.    whom are CompuServe SysOps. However, you may find either 'creature 
  50.    comfort' or actual bugs.
  51.  
  52.    Please let me know of any problems you may find or modes of operation 
  53.    that would give you greater creature comfort. I'll get msgs left on CIS 
  54.    on the IBM PC SIG (PCS-131).
  55.  
  56.    PLEASE NOTE THAT THE COMPUSERVE IBM PC SIG WILL PROVIDE SUPPORT FOR THIS 
  57.    VERSION OF PC-TALK III.
  58.  
  59.  
  60.          -- Jim Gainsley (SysOp) CompuServe IBM PC SIG [76703,1007] --
  61.  
  62.  
  63.  
  64.                                    1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                              PC-TALK III VERSION C
  71.  
  72.         DOCUMENTATION FOR UPDATES INCORPORATED IN PC-TALK III VERSION C
  73.                                  Level 851111
  74.                           (Documentation Revision 7.0)
  75.  
  76.               by Jim Gainsley, 116 Third Ave N., Mpls MN 55401
  77.               (612) 338-6124  CompuServe [76703,1007] 11/11/85  
  78.  
  79.                Licensed for Posting on the CompuServe IBM PC SIG 
  80.                        by The PC-TALK III Copyright holder: 
  81.                 The Headlands Press, Inc. and Andrew Fluegelman
  82.                            Copyright 1983, 1984, 1985
  83.  
  84.  
  85.                                    IN MEMORIAM
  86.  
  87.        Though not positively confirmed, at this writing it is believed that 
  88.        Andrew Fluegelman has passed away.  I've done this work and 
  89.        promulgated it, in the hope that it will benefit others, as much it 
  90.        has benefited me.  In addition, this work is now dedicated to his 
  91.        memory, in the hope that it will serve to continue the philosophy of 
  92.        useful affordable software, which Andrew pioneered.
  93.  
  94.        The additions herein which I have written and compiled from the work 
  95.        of others, which by themselves, now amount to more code than in the 
  96.        total original program. Though I ask no remuneration, I do ask that 
  97.        you, as a satisfied beneficiary of the product, make a special 
  98.        effort in this circumstance to comply with the FREEWARE(tm) 
  99.        principle founded by Fleugelman, and remit the suggested $35. to his 
  100.        family business, the Headlands Press.
  101.  
  102.                                 *   *   *   *   *
  103.  
  104.       *** NOTE: TO RUN THIS VERSION, YOU MUST HAVE 192K OF FREE MEMORY. 
  105.                 THIS MEANS THAT YOU WILL NEED 256K OF RAM, IF YOU USE 
  106.                 PROGRAMS THAT REMAIN RESIDENT, SUCH AS SIDEKICK, SUPERKEY, 
  107.                 PROKEY ETC. 
  108.  
  109.        The chronological list of enhancements has grown very long, and my 
  110.        versions of PC-TALK have become widely distributed and known to 
  111.        many.  Thus, the habit of maintaining a full listing is being 
  112.        discontinued, to save users time and expense in downloading much 
  113.        material which may be redundant or unimportant to them. Henceforth, 
  114.        just the enhancements in the current version will be given.
  115.  
  116.        There are many, many versions and modifications of PC-TALK III.  The 
  117.        license provides that my work will be denoted by the use of version 
  118.        letters, A, B, C, and, I hope, etc! 
  119.  
  120.  
  121.        ENHANCEMENTS IN VERSION C, LEVEL 851111:
  122.  
  123.        1)   ALT-N: Implements the use of the SHELL Command. This command 
  124.             may also be used in Macros, and can access DOS command 
  125.             sequences stored in the ALT-1/0 keys.  Also, the CTTY command 
  126.             can be used to provide remote operation of the computer.
  127.  
  128.  
  129.  
  130.                                    2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.        2)   CRC error checking has been added to the XMODEM file transfer 
  137.             routines.  Also, the speed of the Xmodem routines has been 
  138.             greatly increased.
  139.  
  140.        3)   A 20-block moving average tabulation has been added to the 
  141.             Xmodem receive screen and the screen has been re-organized. 
  142.             Block xfer time indication has been added to the xmit screen. 
  143.             An embedded "M" command allows reset of MAX TIME reading.
  144.  
  145.        4)   The ALT-F, Default Routine, has been rewritten, adding 10 
  146.             additional user programmable defaults.  NOTE: THE DEFAULT FILE, 
  147.             PC-TALK.DEF, WILL BE RE-INITIALIZED THE FIRST TIME YOU RUN THE 
  148.             PROGRAM!!  You may now elect to send Line Feeds, alter the 
  149.             default character for the macro command delimiter and the time 
  150.             delay produced in a macro.  15 character positions have been 
  151.             added to the MODEM INIT capacity.  Also, this string is sent 
  152.             when the Default routine is exited.  A modem de-initialize 
  153.             string has been provided, which is sent when you exit the 
  154.             program.  It is now possible to strip ASCII 0 (00h) in the 
  155.             Default routine.
  156.  
  157.        5)   ALT-V provides a full DOS directory listing, File, Size, Date.
  158.  
  159.        6)   The ALT-P routine has been re-written to provide protocol and 
  160.             baud rate changes up to 9600.  Additionally, the com line is no 
  161.             longer broken when these parameters are changed, thus DTR 
  162.             support is no longer a problem in any portion of the program. 
  163.  
  164.        7)   The ALT-D Dial Directory has been rewritten to allow for user 
  165.             expansion *and* contraction from 4 to 66 pages of 15 entries 
  166.             each, 990 entries total.  Also, you may now go directly to a 
  167.             desired page, rather than just F(orward) and B(ackward) as 
  168.             before.  NOTE: THIS ENHANCEMENT WILL *NOT* CAUSE YOUR CURRENT 
  169.             DIAL DIRECTORY TO BE REINITIALIZED.  Changes have been made to 
  170.             speed up the screen work in this routine also.  Sight-impaired 
  171.             persons who use opticon screen readers, have a problem with 
  172.             inverse video, which is used in portions of the program.  An 
  173.             embedded command, "Z", in the ALT-D routine, changes inverse 
  174.             video throughout the program to hi-inten.
  175.  
  176.        8)   The cursor and time clock code has been changed to provide a 
  177.             more robust flicker-free cursor.
  178.  
  179.        9)   Provision has been made for adaptive dialing features and 
  180.             recognition of the the extended return codes used in the US 
  181.             Robotics, Courier 2400.
  182.  
  183.        10)  The Macro system: a) A dial entry number can now be specified 
  184.             with just the significant characters, i.e. what was say -01, 
  185.             can now be entered as -1, (or -01, if you want).  b) Provision 
  186.             has been made to allow loading an alternate Altkey file within 
  187.             a macro. The Type 4 command is used for this, with a letter A-Z 
  188.             following.  c) The code has been improved to provide additional 
  189.             speed, error trapping, and is now more robust.
  190.  
  191.        11)  The entire program has been re-organized in this version to be 
  192.             compiled with the IBM BASIC COMPILER Version 2.0, including the 
  193.             development of Subprogram libraries.  This permits and will 
  194.  
  195.  
  196.                                    3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.             permit a vastly expanded program now and in the future.
  203.  
  204.        BIBLIOGRAPHIC DATA & SOURCES  (All files necessary to this pgm are 
  205.        public domain, except for #1, which is User Supported Software.)
  206.  
  207.        1)   PC-TALK III, Ver 3.0, Level 830424: Andrew Fluegelman, The 
  208.             Headlands Press, P.O. Box 862, Tiburon, CA 94920  
  209.  
  210.        2)   PCT3SC.MRG -- Split-Screen: Wes Meier,  Source: CIS
  211.  
  212.        3)   PCFIX2.MRG -- Automatic switching of comm params for XMODEM: 
  213.             Author unknown. Source: Gene Plantz, Chicago BBS
  214.  
  215.        4)   DSK.BAS, DSK.DOC, DSK.ASM, DSK.OBJ -- Give disk free space 
  216.             under View File (Alt-V). I've enhanced this to operated in the 
  217.             file xfer modules & modified it to read over 1mb. Also in this 
  218.             version, I've added a full DOS directory display. By: Jack 
  219.             Wright Source: Ben Blackstock, Hawkeye BBS Iowa. 
  220.  
  221.        5)   Portions of PCT35.MRG & PCT36.MRG -- Used here are: Load/Unload 
  222.             Alt-1/0 keys from/to a file, Get a new Sub-directory.  Several 
  223.             fixes were made. Also fixed a couple things in the Alt-Key 
  224.             section, one of which now makes it possible to enter a filename 
  225.             longer than 3 char. when entering after exiting the dialing 
  226.             directory. John Chapman, Source: CIS  
  227.  
  228.        6)   SPLITFIX.MRG, provides for sending multiple lines in Split-
  229.             Screen mode, and one fix for Backspace when ECHO is ON, in 
  230.             split mode. (We made one fix to this mod to prevent crashes in 
  231.             the compiled ver. when bckspcg beyond position 1 in line 25.) 
  232.             Also modified code to work with macros re cursor positioning.:
  233.             by Dennis Cheves, Source: Tampa IBM-PC BBS.
  234.  
  235.        7)   FIX366.MRG: Allows DTR support. When using the older Hayes 1200B 
  236.             modem which requires a DTR signal at all times, you will not be 
  237.             disconnected when the program automatically switches comm 
  238.             parameters, in file xfer modes. Does not fix this problem in 
  239.             the Alt-P routine.  Author: Dan Frank. Source: Gene Plantz 
  240.             IBBS, Chicago.
  241.  
  242.        8)   SKIP GILBRECH: Provided the code forming the basis for enabling 
  243.             baud rate change, without dropping the com line, in the Alt-P.
  244.  
  245.        9)   CRC error checking in XMODEM: Provided a BASIC implementation of 
  246.             the CCITT standard.: by Walt Kloss under a grant from David 
  247.             Huxford.
  248.  
  249.        10)   I have written the following: 
  250.             -- New Freeware Notice screen and presentation.
  251.             -- New Start-up Screen and Command Summary Menu.  
  252.             -- New Redial routine with Recycle command 'R' and change 
  253.                disconnect time ']'.  
  254.             -- New Hangup routine, Alt-H.  New options provision for Manual 
  255.                dialing.  
  256.             -- Function Key timed and character pacing routine, including 
  257.                ability to access dialing directory and do commands from 
  258.                macros.  Fully automatic sequencing is possible.  
  259.             -- Access macros from command line. 
  260.  
  261.  
  262.                                    4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.             -- The use of ESC for terminating file transmit and receive modes.
  269.             -- Continuous clock displayed on line 25.  
  270.             -- Improvements in message line handling.  
  271.             -- Rewrite of the XMODEM file transfer routines, to enable 
  272.                successful operation in network environments. Also many 
  273.                enhancements providing more efficiency and sensitivity to the 
  274.                communications environment.  User controllable XMODEM timing in 
  275.                Receive Mode. Select from 2-70 secs/block, default = 10 secs. 
  276.                Also, greatly enhanced screen work showing Actual Time, Max 
  277.                time, & Timing per block, as well as block length. In transmit 
  278.                mode, manual block resend is possible. 
  279.             -- Enhanced Free Disk Space to operate in all File modes & to be 
  280.                automatic in Receive. Also, to show space over 1mb & work with 
  281.                up to 6 drives (3 previously).
  282.             -- New Time Display Module, providing complete Start, Stop and 
  283.                elapsed times for all file xfers and hhmmss display for Alt-Z.
  284.             -- Implementation of the SHELL command in Alt-N and in disk 
  285.                directory display routines.
  286.             -- Many misc. items regarding cleanup and fixes.
  287.  
  288.  
  289.  
  290.      I want to thank all the others for the super contributions they have 
  291.      made to the continuing development of the finest comm program that 
  292.      ever was!
  293.                -jg-
  294.  
  295.        THE FOLLOWING PAGES REPLACE THE EQUIVALENTS IN THE PC-TALK III 
  296.        MANUAL, FOR THE LEVEL 830424 RELEASE.
  297.  
  298.        IF YOU DO NOT HAVE THAT ORIGINAL DOCUMENTATION, YOU MAY OBTAIN IT
  299.        BY DOWNLOADING THE FILE PCTORG.DOC ON THE COMPUSERVE IBM PRO SIG.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                    5
  329.  
  330.  
  331.                  --- PC-TALK III User's Guide  (Rev. 7) ---   
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                 === Contents ===
  339.  
  340.  
  341.  
  342.  
  343.         To Users of PC-TALK version 2.00                        4 
  344.         Summary of Commands                                     6
  345.         Making Working Copies of PC-TALK                        9
  346.         Starting PC-TALK                                       11
  347.  
  348.  
  349.         === Screen, Keyboard, and Printing ===
  350.  
  351.         Echo:                              Alt-E               13
  352.         The Width Alarm:                   Alt-W               13
  353.         Printscreen:                       Shift-PrtSc         14
  354.         Simultaneous Printout:      Ctrl-PrtSc (or Ctrl-PgUp)  14
  355.         Screendump:                        Alt-S               16
  356.         Clearscreen:                       Alt-C               16
  357.                                                                
  358.  
  359.         === Receiving and Transmitting Files ===
  360.  
  361.         Receiving a File:                  Alt-R (or PgDn)     17
  362.         Transmitting a File:               Alt-T (or PgUp)     19
  363.         The Binary transmit option:        '=b '               20
  364.         The Pacing transmit option:        '=p '               21
  365.         XMODEM Transmitting and Receiving: '=x ' & '=c'        24
  366.         A Note on Communications Terminology                   26
  367.  
  368.  
  369.         === More File Commands ===
  370.  
  371.         Status Messages:                  Alt-M                27
  372.         Viewing a File & Disk Free Space: Alt-V                28
  373.           (See also bottom of Page 18)
  374.         Deleting a File:                  Alt-Y                29
  375.         The Logged Drive:                 Alt-L                29
  376.         File Specification Conventions                         30
  377.  
  378.  
  379.         === Dialing ===
  380.  
  381.         The Dialing Directory:            Alt-D                32
  382.         Adding to the Directory                                34
  383.         Other Directory Options                                35
  384.         Auto-dialing                                           36
  385.         Long Distance Services:           '+# ' and '-# '      36
  386.         Manual Dialing:                   'm '                 38
  387.         Redialing:                        Alt-Q                38
  388.         Stripping and Converting Characters                    39
  389.         Pacing Instructions                                    41
  390.  
  391.  
  392.  
  393.  
  394.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  395.  
  396.  
  397.                  --- PC-TALK III User's Guide  (Rev. 7) ---   
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.         === Parameters and Defaults ===
  407.  
  408.         Communications Parameters:           Alt-P             44
  409.         Program Defaults:                    Alt-F             45
  410.                                                                
  411.  
  412.         === Macros and Input Strings ===
  413.  
  414.         The Function Key Directory:          Alt-K (or Alt-J)  52
  415.         Using the Function Key Assignments                     53
  416.         Pacing, Timed & Character                              54A
  417.         Use of Alt Keys, Alt-1 thru 0.            Shift-TAB    55
  418.         Directory Display for Alt-1 thru 0 keys.  Alt-A        55
  419.         Saving & Recalling Alt key assignments:  Alt-U, Alt-I  57
  420.  
  421.         === Miscellaneous Features and Commands ===
  422.  
  423.         Elapsed Time                         Alt-Z             58
  424.         Exit                                 Alt-X             58
  425.         Sending a Break Signal               Ctrl-End          58
  426.         Command Summary                      Home key          59
  427.         Split-Screen operation               Cntrl-Home        59
  428.         Select another Subdirectory          Alt-G             59
  429.         Hangup                               Alt-H             59
  430.         Run Silent                           Alt-B             59
  431.         Do DOS Commands                      Alt-N             59
  432.         Using the Command Line                                 59A
  433.         Toggle Commands                                        60
  434.         Clock Display, Update Disable        Alt-D  'y'        60
  435.         Inverse Video Toggle                 Alt-D  'z'        60    
  436.         
  437.  
  438.         === More Applications and Advanced Features ===
  439.  
  440.         XON/XOFF:                            Alt-O (letter)    60A
  441.         Communications Errors:  <<>> & <<OVERFLOW>>            60A
  442.  
  443.  
  444.         === PC-TALK III File Information ===
  445.  
  446.         Programming Information                                63
  447.         Copying PC-TALK                                        64
  448.         Modifying PC-TALK                                      64
  449.         Thank You!                                             66
  450.         FREEWARE                                               67
  451.                                                                
  452.         Appendix A: Communications Parameters                  69
  453.         Appendix B: The XMODEM Protocol                        70
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                   --- PC-TALK III User's Guide  (Rev. 7) ---             6
  467.  
  468.  
  469.  
  470.  
  471.                            === Summary of Commands ===
  472.  
  473.  
  474.         Home               Displays an on-screen summary of these commands.
  475.  
  476.         Ctrl-Home          Split-Screen Operation.  Keyboard input appears
  477.                            at bottom of screen. (Hit Esc to erase line.)
  478.  
  479.  
  480.         Ctrl-PrtSc         When activated, simultaneously prints all 
  481.         (or Ctrl-PgUp)     screen output to the printer. (Toggle)
  482.  
  483.  
  484.         Ctrl-End           Sends a 'Break' signal to the remote computer.
  485.  
  486.         Shift-PrtSc        Prints current screen contents at any time.
  487.  
  488.         Shift-TAB          Permits programming of keys Alt-1 through Alt-0 
  489.                            as temporary input while the program is running.
  490.  
  491.         Alt-A              Directory Display for Alt keys 1 thru 0.
  492.  
  493.         Alt-B              Run Silent, almost... Audible signals are still 
  494.                            provided in the event of errors, invalid or, 
  495.                            illegal events.
  496.  
  497.  
  498.         Alt-C              Clears the screen.
  499.  
  500.  
  501.         Alt-D              Calls up the Dialing Directory. Permits 
  502.                            storing parameters for 60 phone numbers and 
  503.                            auto-dialing.
  504.  
  505.  
  506.         Alt-E              When activated, Echoes keyboard input to the 
  507.                            screen. (Toggle) USE IF YOUR KEYBOARD INPUT IS 
  508.                            BLANK OR DOUBLE.
  509.  
  510.  
  511.         Alt-F              Permits temporary or permanent changes to the
  512.                            program defaults.
  513.  
  514.  
  515.         Alt-G              Select another Subdirectory on the same drive.
  516.  
  517.  
  518.         Alt-H              Hangup: Disconnects from telephone line.
  519.  
  520.  
  521.         Alt-I              Programs the contents of a Temp Alt Key file to
  522.                            the designated Alt keys 1 thru 0.
  523.  
  524.  
  525.  
  526.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                   --- PC-TALK III User's Guide  (Rev. 7) ---             7
  533.  
  534.  
  535.         Alt-J              Calls up the Function Key Directory.  Permits 
  536.         (or Alt-K)         specifying up to 40 Function key combinations 
  537.                            to input permanent i.d. #s and logon 
  538.                            sequences.
  539.  
  540.         Alt-L              Changes the Logged drive for file specifications.
  541.  
  542.  
  543.         Alt-M              When activated, sends status Messages as part 
  544.                            of the transmit and receive routines.  
  545.                            (Toggle)
  546.  
  547.         Alt-N              Do Dos Commands. This feature makes use of the 
  548.                            DOS SHELL command. 
  549.  
  550.  
  551.         Alt-O              Permits re-starting transmission manually when 
  552.                            the remote computer has sent an XOFF signal.
  553.  
  554.  
  555.         Alt-P              Permits changing the communications Parameters.
  556.         
  557.  
  558.         Alt-Q              Redials the last number dialed. "R" to recycle, 
  559.                            Space Bar to Terminate, Alt-D to directly access 
  560.                            Dialing Directory, "]" to change Time-Delay-
  561.                            before-disconnect, plus 3 options to temporarily 
  562.                            change disconnect time. Allows fast recycling.
  563.  
  564.  
  565.         Alt-R              Starts routines to Receive input from the
  566.         (or PgDn)          communications port to files on disk. Sub-
  567.                            commands allow display of disk directory and 
  568.                            free space.  Press ESC to terminate.
  569.  
  570.         Alt-S              Writes contents of the screen to a file 
  571.                            DMP.PCT on the Logged drive.
  572.  
  573.         Alt-T              Starts routines to Transmit files from disk
  574.         (or PgUp)          through the communications port. Can also 
  575.                            obtain disk free space & disk directory. Press 
  576.                            ESC to terminate.
  577.  
  578.         Alt-U              Stores the contents of the Temp Alt Keys 1 thru 0 
  579.                            in disk file. 
  580.  
  581.         Alt-V              Starts/stops routine to View a file which has 
  582.                            been saved to disk.  Gives disk free space.
  583.  
  584.         Alt-W              Sets an optional Width alarm for keyboard input.
  585.  
  586.         Alt-X              Exits the program and returns to DOS.
  587.  
  588.         Alt-Y              Permits deleting a file from disk.
  589.  
  590.  
  591.  
  592.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                   --- PC-TALK III User's Guide (Rev. 7) ---              8
  599.  
  600.  
  601.         Alt-Z              Displays the elapsed time for the current call.
  602.  
  603.         ESC                Aborts all file xfer routines & Macros.
  604.  
  605.         File Specification Commands:
  606.  
  607.           / or  /+[spec] - When given as response to a file specification, 
  608.           ? or  ?+[spec]   lists files currently on logged or specified 
  609.                            drive. Wild card characters * and ? are 
  610.                            allowed. ? may be used in place of /.
  611.  
  612.                  <space> - When given as response to file specification, 
  613.                            re-inputs the last file Transmitted, Received, 
  614.                            or Viewed.
  615.  
  616.                 <Enter>  - When given as response to file specification,
  617.                            cancels Transmit, Receive, View, & Delete routines.
  618.  
  619.                 =p[n][z] - When added to the end of a Transmit file 
  620.                            specification, paces transmission one line at a 
  621.                            time--either every n seconds or after the wait-for
  622.                            prompt character (z) is received.
  623.  
  624.                     =b   - When added to the end of a Transmit file 
  625.                            specification, permits transmitting file in 
  626.                            binary format.
  627.  
  628.                =c   =x   - When added to the end of a Transmit or Receive 
  629.                            file specification, invokes the XMODEM error-
  630.                            checking protocol.  Communications parameters are 
  631.                            automatically changed to the required No parity, 
  632.                            8 data bits & 1 Stop bit.  When '=x' is used, 
  633.                            error checking is done via Checksum, and when 
  634.                            '=c' is used error checking is done via CRC.  
  635.                            Note: When you are the Sender, it doesn't matter 
  636.                            which you use, since the Receiver will determine 
  637.                            which protocol to use... CRC has priority.
  638.  
  639.          
  640.              =c[n]  =x[n]  Used with RECEIVE via XMODEM mode. n is a number 
  641.                            between 2 & 70, which controls block timing. For 
  642.                            use with networks, & where long pauses may occur. 
  643.                            Default for n = a timing of 10 seconds/block. 
  644.  
  645.                     Tab  - Pressing while receiving via Xmodem allow you to 
  646.                            change timing. See Text before attempting to use.
  647.  
  648.                   \   M  - The '\' is used to manually resend the current 
  649.                            block during Xmodem UPLOADS, when the msg. 
  650.                            'Waiting...' appears.  'M' can be used to reset 
  651.                            the 'Max Time' indicator, during DOWNLOADS.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                   --- PC-TALK III User's Guide (Rev. 7) ---              8A
  665.  
  666.  
  667.       Special Characters Used in Strings (Macros): (For F-Keys & Alt-1/0 Keys)
  668.  
  669.                     |  - Switch Character: Used to indicate the beginning of 
  670.                          a string segment within a macro. The next character 
  671.                          must a Type no. 1-5. Can be changed in Defaults.
  672.  
  673.                     ~  -   (Tilde) Time Delay Character. The character and 
  674.                            the time can be changed in the Defaults.
  675.  
  676.                     }  - Signifies a carriage return as part of the string.
  677.  
  678.       Subcommands Used in String (Macro) Editing:
  679.  
  680.         <space><Enter>   - Clears a previously specified string.
  681.                <Enter>   - Leaves a previously specified string unchanged.
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                   --- PC-TALK III User's Guide (Rev. 7) ---               8B
  732.  
  733.             The PC-TALK III Version C, Level 851111 Start-up Screen
  734.  
  735.             ==============================================  
  736.             |          =====  PC-TALK III  =====         |  
  737.             |  Experimental Mod Version C. For the use   |  
  738.             |   of, and supported by, the IBM PC SIG.    |  
  739.             | Compiled by Jim Gainsley (SysOp) 76703,1007|  
  740.             |  Licensed for posting by written agreement |  
  741.             |        with The Headlands Press, Inc.      |  
  742.             ==============================================  
  743.             |                                            |  
  744.             |   PRESS: <Home>: For Command Summary.      |  
  745.             |         <Alt-E>:   If you cannot see       |  
  746.             |                    your keyboard input.    |  
  747.             |     <Ctrl-Home>:     Split-Screen ON/OFF   |  
  748.             |                      (Toggle). Use <ESC>   |  
  749.             |                      to erase line & the   |  
  750.             |                      <CR>  substitute to   |  
  751.             |                      send multiple lines.  |  
  752.             |                                            |  
  753.             |                 DOS 2.1 & up               |  
  754.             |                 Level 851111               |  
  755.             ==============================================  
  756.  
  757.  
  758.             The PC-TALK III Version C, Level 851111 Command Summary
  759.  
  760.                ========================================        
  761.                |  ===PC-TALK III  COMMAND SUMMARY===  |     
  762.                ========================================     
  763.                |Shft-PrtSc=Prnt Scrn  ^PgUp=Contin Prnt|       
  764.                | =x =c XMODEM '=p' Pacing '=b' Binary |     
  765.                | Shft-TAB- Set/Clear Temp Alt Keys    |     
  766.                | Alt-A  Disp Alt-1/0  Alt-B  Silent   |     
  767.                | Alt-C  Clearscreen   Alt-D  Dial Nmbr|     
  768.                | Alt-E  Echo Toggle   Alt-F  Defaults |     
  769.                | Alt-G  Get a New Subdirectory        |     
  770.                | Alt-H  Hang up (Disconnect)          |     
  771.                | Alt-I  Set Alt-1/0 from file         |     
  772.                | Alt-J  Set/Clear Func Keys (Alt-K)   |     
  773.                | Alt-L  Chge Def Drv Alt-M  Messages  |     
  774.                | Alt-N  Do DOS Cmd   Alt-P  Com Parms |     
  775.                | Alt-Q  Redial Nmbr  Alt-R  Recv File |     
  776.                | Alt-S  Screendump   Alt-T  Xmit File |     
  777.                | Alt-U  Unload Alt-1/0 to file        |     
  778.                | Alt-V  View a File & Show Free Space |     
  779.                | Alt-W  Set Margin Width Alarm        |     
  780.                | Alt-X  eXit to DOS                   |     
  781.                | Alt-Y  Delete a File    Alt-Z  Time  |     
  782.                |Ctrl-End = Send Sustained Break Signal|     
  783.                ========================================
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                   --- PC-TALK III User's Guide  (Rev. 7) ---             18
  797.  
  798.  
  799.         characters as they are being received, you can specify those 
  800.         characters with the Strip option described below.
  801.  
  802.         PC-TALK can receive binary files without any special file 
  803.         receiving specification.  You do have to be careful, however, to 
  804.         open and close your file for receiving so that you do not receive 
  805.         any extraneous characters or messages from the remote computer.  
  806.  
  807.  
  808.         The recommended procedure for receiving binary files is to have 
  809.         the Message option (described below) ON for the receiving 
  810.         computer and OFF for the transmitting computer and for the 
  811.         transmitting computer operator to give the receiving computer 
  812.         ample time to open and close the file.  
  813.  
  814.  
  815.         Please note also that if you want to receive a binary file, you 
  816.         must not have any stripping in effect and must be communicating at 
  817.         8 data bits. HOWEVER, this is NOT true as regards XMODEM, where 
  818.         stripping and communications parameter changes are made 
  819.         automatically.
  820.  
  821.         (These communications parameters are described below.)
  822.  
  823.         PC-TALK is also capable of receiving files using the XMODEM 
  824.         error-checking protocol.  The use of this protocol is described 
  825.         separately below.
  826.  
  827.                    ----------------------------------------
  828.  
  829.         Disk Free Space & Directory Functions:
  830.  
  831.        After pressing PgDn (or Alt-R), PgUp (or Alt-T), or Alt-V, the 
  832.        Specification: prompt is presented.  The Msg line will show 
  833.        subcommands available for reading disk directories, free space and 
  834.        files.  Example formats are as follows:  (d: stands for any drive 
  835.        designator, A: B: C: etc.)  
  836.  
  837.        You may use a '?' in place of the '/'.  However, a '/' is an 
  838.        unshifted '?', thus one less keystroke.
  839.  
  840.           
  841.             /    =Directory of logged drive. 
  842.             //   =Directory & free space of logged drive. 
  843.             /d:  =Directory of drive other than logged drive.
  844.             /d:/ =Directory and free space of drive other than logged drive.
  845.  
  846.         
  847.  
  848.         In PC-TALKC a full DOS style directory is given when the / or ? is 
  849.         pressed in the above situations.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                   --- PC-TALK III User's Guide (Rev. 7) ---              20
  863.  
  864.  
  865.         ready to send your file, start the Transmit routine (Alt-T or 
  866.  
  867.         PgUp), specify the file to be sent, and press <Enter>.  None of 
  868.  
  869.         the specification prompts you see on your screen will be sent to 
  870.  
  871.         the remote computer -- only the text of your file.
  872.  
  873.  
  874.         **** NOTE RE PC-TALK VERSION B & UP: ESC is used to terminate
  875.                   all file transfers and NOT Alt-T, R, or PgUp, PgDn.
  876.  
  877.  
  878.         If the remote computer requires a special character to begin 
  879.  
  880.         receipt of the file, it should be sent manually via the keyboard 
  881.  
  882.         prior to giving the Alt-T command.
  883.  
  884.                     ----------------------------------------
  885.  
  886.         **File Transmitting Options:
  887.  
  888.  
  889.         PC-TALK offers some advanced transmit options for sending binary 
  890.  
  891.         files, for pacing transmission, and for transmitting with an 
  892.  
  893.         error-checking protocol.  In each case, the option is invoked by 
  894.  
  895.         adding an equals sign plus the letters 'b', 'p', 'x', or 'c' to  
  896.  
  897.         the end of the file specification.  Each of these options is 
  898.  
  899.         described below; however, it is recommended that you do not try 
  900.  
  901.         these options until you are familiar with the basic features of 
  902.  
  903.         the program. 
  904.                     ----------------------------------------
  905.  
  906.         The Binary transmit option: '=b'
  907.  
  908.         PC-TALK permits transmitting binary files (.COM  and .EXE files 
  909.  
  910.         and BASIC programs not saved in ASCII format).  To transmit a 
  911.  
  912.         binary file, add '=b' to the end of the transmit file 
  913.  
  914.         specification.
  915.  
  916.  
  917.                  For example, to transmit the file MYFILE.COM, you would 
  918.                  give the transmit file specification by typing 
  919.  
  920.  
  921.  
  922.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                   --- PC-TALK III User's Guide (Rev. 7) ---              24
  929.  
  930.  
  931.  
  932.  
  933.         XMODEM Transmitting and Receiving: '=x' or '=c'
  934.  
  935.  
  936.         One of the noteworthy features in PC-TALK III is the inclusion of 
  937.         the XMODEM protocol originally developed by Ward Christensen.  
  938.         The purpose of the XMODEM protocol is to guard against
  939.         inaccuracies in file transfer caused by bad signals on the 
  940.         telephone line. It is a "hand-shaking" and error-checking 
  941.         protocol that ensures accurate transmission and receipt of data 
  942.         and binary files.  The protocol is in wide use today among a 
  943.         variety of microcomputer systems.
  944.  
  945.  
  946.         The XMODEM protocol can be used for both transmitting and 
  947.  
  948.         receiving files.  In each case, you should add '=x' or '=c' to 
  949.  
  950.         your file specifications; for example, 'MYFILE.123=x'.
  951.  
  952.  
  953.         Two forms of error checking are available, Checksum and CRC.  
  954.         Briefly, Checksum is merely the sum of the ASCII codes of all 128 
  955.         data characters in the block, while CRC (Cyclic Redundancy Check) 
  956.         is a complex mathematical function, which is much more sensitive 
  957.         to data errors than Checksum. In the receive mode, '=x' will use 
  958.         Checksum, while '=c' will use CRC, if available.  In the send 
  959.         mode, it does not matter which you enter.  If the receiver can do 
  960.         CRC then it will be used, if not, Checksum will be used.  Note 
  961.         that XMODEM is a RECEIVER controlled protocol, that is, the 
  962.         receiver determines when blocks will be sent and the error 
  963.         checking method to be used.  Many BBS' and networks are not 
  964.         adapted for the CRC method.  This need not be of concern to you, 
  965.         as the program automatically handles these situations.  If you 
  966.         select CRC and it is not available, a message to that effect will 
  967.         be given, but you need do nothing.  You should note it however, so 
  968.         that you will not choose it there next time, since a certain 
  969.         amount of time is wasted in making the determination.  The CRC
  970.         implementation used is the CCITT standard.
  971.  
  972.         Once you have entered the file spec and pressed <Enter>, you will 
  973.         see a message indicating that the protocol is in effect and the 
  974.         notice, "*** Holding for Start..."  The rest of the file transfer 
  975.         occurs automatically.
  976.  
  977.  
  978.         If you are transmitting, line 25 of the screen will indicate how 
  979.         many blocks (of 128 bytes) comprise the file.  You will see a 
  980.         message "Sending block # n", followed by the message "- verified" 
  981.         when the remote computer has successfully received that block.  
  982.         The file transfer will proceed, block by block, until the end of 
  983.         the file is reached.  The transfer will then terminate 
  984.         automatically.
  985.  
  986.  
  987.  
  988.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                   --- PC-TALK III User's Guide (Rev 7) ---               26
  995.  
  996.  
  997.         reasonably assured of a rapid and accurate file transfer.
  998.  
  999.  
  1000.         The XMODEM routine operates automatically.  For those who are 
  1001.         interested, a brief technical description of how the file 
  1002.         transfer takes place can be found in Appendix B at the end of 
  1003.         this documentation.
  1004.  
  1005.         Before leaving the subject of XMODEM, it is appropriate that 
  1006.         acknowledgment be given to Ward Christensen, who originated the 
  1007.         protocol and who has been a landmark pioneer in computer 
  1008.         communications.
  1009.  
  1010.                     ----------------------------------------
  1011.  
  1012.         Advanced Features:
  1013.  
  1014.         Multi-user networks may have long pauses in transmission. In 
  1015.         order to operate with these, it may be necessary to vary the block 
  1016.         timing in the RECEIVE mode. Since the implementation of XMODEM in 
  1017.         PC-TALK is such that the protocol is receiver driven, i.e. the 
  1018.         receiver controls all transmission, no provision need be made for 
  1019.         the transmit mode, except that if the msg "*** Waiting..." appears, 
  1020.         you may manually resend the current block by pressing the '\' within 2 
  1021.         seconds after the appearance of the msg. However, IT IS HIGHLY 
  1022.         RECOMMENDED THAT YOU NOT ATTEMPT THIS UNTIL AFTER 3 APPEARANCES OF THE 
  1023.         MESSAGE, OR IN THE EVENT THAT THE XFER APPEARS TO BE HUNG UP. Waits 
  1024.         are common in network xfers, so don't be impatient... Let the program 
  1025.         do the work.
  1026.  
  1027.         THE DEFAULT OR STANDARD TIMING IS SET AT 10 SECONDS. However, you 
  1028.         may vary this from 2 to 70 seconds by typing the desired time 
  1029.         after the '=x' e.g. =x4, WHICH SHOULD BE USED WITH NON-NETWORKS, SUCH 
  1030.         AS ORDINARY BBS's.  Longer periods such as 20 or 30 seconds are common 
  1031.         with networks such as CompuServe, during "busy" periods, when many 
  1032.         "slows" are being experience. (A "slow" is just a term meaning bursts 
  1033.         of characters, with relatively long periods, between them.)
  1034.  
  1035.         Note however, that provision is made for automatic incrementing of 
  1036.         the block timing. Two steps are provided, 30 secs, and 60 secs. 
  1037.         Decrementing is not provided, nor is it mandatory. In passing it is 
  1038.         to be noted that some BBS's notably IBBS requires that the timing 
  1039.         *at the end of the transfer* be no greater than 4 seconds per block.  
  1040.         Therefore, the timing is automatically reset to 4 seconds at this 
  1041.         point. This also results in a faster termination sequence in all 
  1042.         cases. The effect of long times in block timing, is to prolong error 
  1043.         correction conditions.
  1044.  
  1045.         The screen gives the time per block, the maximum time for a block, 
  1046.         received up to the current block, a 20-blk moving average, and the 
  1047.         block timing in effect -- all in seconds. If this display indicates 
  1048.         that you are nearing or exceeding the timing you have allowed, you 
  1049.         may change it by pressing TAB and then two digits e.g. 06, 15, etc. 
  1050.         between 02-70, the timing limits. DO NOT PRESS ENTER. The program 
  1051.         WAITS for you to enter these digits, so don't dally! NOTE: Longer 
  1052.  
  1053.  
  1054.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                   --- PC-TALK III User's Guide (Rev 7) ---              26A
  1061.  
  1062.  
  1063.  
  1064.         times increase the probability of xmission errors, which mean more 
  1065.         blocks needing retransmission and also increase the abort, error and 
  1066.         exit sequence times. 
  1067.  
  1068.         Pressing 'M' in receive mode, will cause the MAX TIME indicator to 
  1069.         be reset to the current block. You may have to hold the key down or 
  1070.         press it several times quickly to achieve the reset.
  1071.  
  1072.         Note that during Send mode, you cannot alter block timings.
  1073.  
  1074.         REMEMBER, "IF IT AIN'T BROKE, DON'T FIX IT!". Timing changes are 
  1075.         automatic. Your intervention should not be necessary except under 
  1076.         unusual conditions or as noted above.  
  1077.  
  1078.         In Xmodem Receive mode, you will be given the total block length 
  1079.         after the first block is received, which information maybe of 
  1080.         interest to some.  Information is also presented during the transfer 
  1081.         concerning error conditions.  The standard block length is 132 bytes 
  1082.         including the protocol bytes, sometimes called 'overhead', when 
  1083.         Checksum ('=x') is used, and 133 bytes when CRC, ('=c') is used. The 
  1084.         data portion of all implementations is 128 bytes.
  1085.  
  1086.                         ______________________________________
  1087.  
  1088.  
  1089.         A Note on Communications Terminology --
  1090.  
  1091.         The PC-TALK prompts and documentation generally avoid use of the 
  1092.  
  1093.         words 'uploading' and 'downloading', except where clarity is served. A 
  1094.  
  1095.         convention in the mainframe world has been to use 'uploading' to refer 
  1096.  
  1097.         to transmitting a file to a remote computer and 'downloading' to 
  1098.  
  1099.         refer to receiving a file from a remote computer.  In the case of 
  1100.  
  1101.         two microcomputers communicating with each other, the notion of 
  1102.  
  1103.         'up' and 'down' seems less appropriate.  However, where these words 
  1104.  
  1105.         are used, they do have the meanings given here.
  1106.  
  1107.  
  1108.                       ------------------------------------------
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                   --- PC-TALK III User's Guide (Rev. 7) ---              32
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.                                  === Dialing ===
  1134.  
  1135.  
  1136.  
  1137.         The Dialing Directory: Alt-D
  1138.  
  1139.  
  1140.         The Alt-D command calls up the Dialing Directory, which is one of 
  1141.         PC-TALK'S  most useful features.  The Directory as supplied can 
  1142.         list up to sixty names and phone numbers, plus communications 
  1143.         parameters and echo, message, stripping and pacing instructions 
  1144.         for each entry.  The Directory can be expanded to 990 entries.
  1145.  
  1146.  
  1147.         The following instructions will first show you how to place names 
  1148.  
  1149.         and phone numbers into the Directory and then describe how to use 
  1150.  
  1151.         the Directory as part of your standard communications routines.
  1152.  
  1153.  
  1154.         When the Directory is called up for the first time, all entries 
  1155.  
  1156.         will be blank. To add names and phone numbers to the Directory or 
  1157.  
  1158.         to revise the Directory later on, enter 'r' at the "Dial entry 
  1159.  
  1160.         #:" prompt. Then enter the entry number you want to add or revise. 
  1161.  
  1162.  
  1163.         Note: It is not necessary to press <Enter> for any Dial 
  1164.               Directory single-letter command, and it does not matter 
  1165.               whether you use upper or lower case any place in PC-TALK.
  1166.  
  1167.  
  1168.         Note:  In what follows below, pressing <Enter> installs the 
  1169.                parameter or condition then indicated on the screen.
  1170.  
  1171.         To add/revise entries, type in the name, followed by, and 
  1172.  
  1173.         the phone number (area codes optional), followed by.  Up 
  1174.  
  1175.         to 36 characters may be specified for the phone number; only the 
  1176.  
  1177.         rightmost 14 characters will be displayed in the Directory.
  1178.  
  1179.  
  1180.         You will then be asked whether the communications parameters are 
  1181.         "ok". If say, the screen shows 1200 baud-Even parity-7 data bits-
  1182.         1 stop bit, and this is acceptable, then type 'y'. 
  1183.  
  1184.  
  1185.  
  1186.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                   --- PC-TALK III User's Guide (Rev. 7)                  33
  1193.  
  1194.  
  1195.  
  1196.         (Note: PC-TALKC supports Adaptive Dialing.  If you set your baud 
  1197.         rate for 2400 baud, and have a modem that has provides for 
  1198.         "Adaptive Dialing", which means that the modem will automatically 
  1199.         switch to 1200 baud if the remote computer does not support 2400 
  1200.         baud, then PC-TALKC, will also automatically change to 1200 baud.) 
  1201.  
  1202.         If you respond with 'n', you will be asked to specify 
  1203.         communications parameters. The program will not let you dial 
  1204.         using invalid parameters. (If you run into trouble, re-specify 
  1205.         '1200-E-7-1'.)
  1206.  
  1207.  
  1208.         The revise entry routine will then ask whether you want to echo 
  1209.  
  1210.         characters to the screen (common for inter-personal computer 
  1211.  
  1212.         communications, but usually not necessary for public networks 
  1213.  
  1214.         such as CompuServe and the Source), and whether you want to send 
  1215.  
  1216.         status messages as part of the file Receiving and Transmitting 
  1217.  
  1218.         routines (see above). Press <Enter> after responding to each 
  1219.  
  1220.         prompt.
  1221.  
  1222.  
  1223.         The routine will then ask whether you want to strip or convert 
  1224.  
  1225.         characters for that entry.  It is recommended that you respond 
  1226.  
  1227.         with 'n' unless you have a special applications need. (See the 
  1228.  
  1229.         explanation of the Stripping option below.)
  1230.          
  1231.  
  1232.         Finally, the routine will ask whether you want to specify a 
  1233.         Pacing instruction for that entry.
  1234.  
  1235.  
  1236.         If you want to specify a Pacing instruction, enter either a time 
  1237.         delay number or a pacing prompt character in response to the 
  1238.         "Pacing? p=" prompt. Respond with 'n' <Enter>, if you do not want 
  1239.         any pacing in effect for that entry. It is recommended that you 
  1240.         do not specify a Pacing instruction unless you know of a specific 
  1241.         need for it. 
  1242.  
  1243.  
  1244.         If you make an error specifying a directory entry, type 'n' 
  1245.  
  1246.         <Enter> at the final "ok?".  You will be taken through the 
  1247.  
  1248.         specification routine again.  For each parameter, you can either 
  1249.  
  1250.  
  1251.  
  1252.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                   --- PC-TALK III User's Guide (Rev. 7) ---              34
  1259.  
  1260.  
  1261.         specify a new value or press <Enter> to leave the present value 
  1262.  
  1263.         unchanged.
  1264.  
  1265.  
  1266.         After you have responded with 'y' to the final "ok?" prompt, the 
  1267.  
  1268.         Directory will clear, showing the new information you input. The 
  1269.  
  1270.         name, phone number, and communications specs will be permanently 
  1271.  
  1272.         stored in a separate file on your program disk named PC-TALK.DIR.
  1273.  
  1274.                     ----------------------------------------
  1275.  
  1276.  
  1277.         Adding to the Directory --
  1278.  
  1279.  
  1280.         As indicated above, specifying communications parameters, echo, 
  1281.  
  1282.         message, stripping, and pacing can all be considered advanced 
  1283.  
  1284.         features that need not be dealt with the first time you use the 
  1285.  
  1286.         program.  The following example lists the commands for merely 
  1287.  
  1288.         adding a name and phone number to the Directory.
  1289.  
  1290.  
  1291.         1. Press Alt-D.  You will see Page 1 of the Directory displayed 
  1292.         and the prompt "Dial entry #:".
  1293.  
  1294.  
  1295.         2. Type 'r'. You will see the prompt "Revise/add entry #:".
  1296.  
  1297.  
  1298.         3. Type '1'. You will see the prompt "Name:".
  1299.  
  1300.  
  1301.         4. Type the name you want for entry #1 (maximum 20 characters) 
  1302.            followed by <Enter>. You will see the prompt "Phone number:".
  1303.  
  1304.  
  1305.         5. Type the phone number you want for entry #1 (maximum 36 
  1306.            characters) followed by <Enter>. You will see the prompt 
  1307.            "Communications parameters ok (y/n)?".
  1308.  
  1309.  
  1310.         6. For this example, the parameters are ok, so type 'y' <Enter>, 
  1311.            or just press <Enter>.  You will see the prompt "Echo on (y/n)?".
  1312.  
  1313.  
  1314.         7. Type 'n' <Enter> or just press <Enter>. You will see the 
  1315.            prompt "Messages on (y/n)?". 
  1316.  
  1317.  
  1318.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                   --- PC-TALK III User's Guide (Rev. 7) ---              35
  1325.  
  1326.  
  1327.  
  1328.  
  1329.         8. Type 'n' <Enter> or just press <Enter>. You will see the 
  1330.            prompt "Strip/convert characters (y/n)?".
  1331.  
  1332.  
  1333.         9. Type 'n' <Enter> or just press <Enter>. You will see the 
  1334.            prompt "Pacing? p=".
  1335.  
  1336.  
  1337.         10. Type 'n' <Enter> or just press <Enter>. You will see the 
  1338.             prompt "Is entry #1 ok (y/n)?".
  1339.  
  1340.  
  1341.         11. Type 'y' <Enter> or just press <Enter>. You will see Page 1 
  1342.             of the Directory re-displayed with the name and phone number 
  1343.             you just entered.
  1344.  
  1345.  
  1346.         12. Repeat the above steps for each name and phone number you 
  1347.             want to add to the Directory.
  1348.  
  1349.                     ----------------------------------------
  1350.  
  1351.         Other Directory Options --
  1352.  
  1353.  
  1354.         Although the Directory has a capacity of sixty entries, the 
  1355.  
  1356.         screen will display only fifteen entries at a time.  You can 
  1357.  
  1358.         "page" forward or back through the directory by entering 'f' or 
  1359.  
  1360.         'b', or 'pn' (where 'n' is a page number), at the initial "Dial 
  1361.  
  1362.         entry #:" prompt.
  1363.  
  1364.  
  1365.         You can dial any entry, regardless of whether it is displayed. 
  1366.         However, you can revise only those entries that are on the 
  1367.         displayed page of the Directory.
  1368.  
  1369.  
  1370.         If you enter 'c' at the "Dial entry #:" prompt, you have the 
  1371.  
  1372.         option of clearing Directory entry #s within the full range the 
  1373.  
  1374.         existing directory entries, used or not, in the directory.  You 
  1375.  
  1376.         will be asked "Are you sure?" before your selected entries are 
  1377.  
  1378.         cleared.
  1379.  
  1380.  
  1381.                     ----------------------------------------
  1382.  
  1383.  
  1384.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                   --- PC-TALK III User's Guide (Rev. 7) ---              36
  1391.  
  1392.  
  1393.  
  1394.  
  1395.         Auto-dialing --
  1396.  
  1397.  
  1398.         The Dialing Directory will automatically dial a Directory entry 
  1399.  
  1400.         if your modem supports this function.
  1401.  
  1402.  
  1403.         The first time the Directory is called up, you will see a notice 
  1404.  
  1405.         that says "modem dialing command = ATDT". This is the command 
  1406.  
  1407.         used by the D.C. Hayes Smartmodems<tm> for using touch tone dialing.
  1408.  
  1409.  
  1410.         To specify a different dialing command--such as for pulse dialing 
  1411.  
  1412.         or for another auto-dial modem--enter 'r' to revise the 
  1413.  
  1414.         Directory and then type 'm' at the "Revise/add entry #:" 
  1415.  
  1416.         prompt. Then type your desired dialing command, followed by 
  1417.  
  1418.         <Enter>.  (The Smartmodem command for pulse dialing would be 
  1419.  
  1420.         'ATDP'.)
  1421.  
  1422.  
  1423.         Whatever modem dialing command you specify will be permanently 
  1424.  
  1425.         stored in the Directory file (until revised again).
  1426.  
  1427.  
  1428.         Once the appropriate dialing command has been entered in the 
  1429.  
  1430.         Directory, you can have the program dial phone numbers 
  1431.  
  1432.         automatically. Simply type the Directory entry # you wish to 
  1433.  
  1434.         call, followed by <Enter>. The phone number listed for that entry 
  1435.  
  1436.         will then be dialed.
  1437.  
  1438.                     ----------------------------------------
  1439.  
  1440.  
  1441.         Long Distance Services:  '+#' and '-#'
  1442.  
  1443.  
  1444.         The Dialing Directory is also able to route calls through 
  1445.  
  1446.         supplemental long distance services such as Sprint<tm> and 
  1447.  
  1448.  
  1449.  
  1450.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                   --- PC-TALK III User's Guide (Rev. 7) ---              37
  1457.  
  1458.  
  1459.         MCI<tm>. Two different service numbers can be stored in the 
  1460.  
  1461.         Directory, which are listed in the Directory as '+#' and '-#'.
  1462.  
  1463.  
  1464.         To add a long distance service number to the Directory, type 'r' 
  1465.  
  1466.         at the "Dial entry #:" prompt.  Then type '+' or '-' plus 
  1467.  
  1468.         at the "Revise/add entry #:" prompt.  You can then 
  1469.  
  1470.         specify a long distance number command.
  1471.  
  1472.  
  1473.         When entering the long distance number, include both your local 
  1474.  
  1475.         access number and your i.d. number. Separate the two numbers with 
  1476.  
  1477.         your modem's "pause" command indicators (commas on the 
  1478.  
  1479.         Smartmodem) so that your i.d. number will not be input until a 
  1480.  
  1481.         connection with the access number has been made. The long 
  1482.  
  1483.         distance service # might thus appear in the Dialing Directory as: 
  1484.  
  1485.         '987 6543,,,,123456'.
  1486.  
  1487.  
  1488.         If your long distance service requires a different sequence -- 
  1489.  
  1490.         such as inputting your account number following the number dialed 
  1491.  
  1492.         -- you can program a Function key combination for your account 
  1493.  
  1494.         number. See "The Function Key Directory" below.
  1495.  
  1496.  
  1497.         Once a long distance service # has been entered into the 
  1498.  
  1499.         Directory, it will reside there permanently (until revised) and 
  1500.  
  1501.         display whenever the Directory is called up.
  1502.  
  1503.  
  1504.         To dial a Directory entry # using the long distance service, 
  1505.  
  1506.         input a '+' or a '-' immediately preceding the desired entry #. 
  1507.  
  1508.  
  1509.                  For example, to dial Directory entry #3 using the 
  1510.  
  1511.                  service number listed as '+#', you would type '+3' 
  1512.  
  1513.                  <Enter> at the "Dial entry #:" prompt.
  1514.  
  1515.  
  1516.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.                   --- PC-TALK III User's Guide (Rev. 7) ---              38
  1523.  
  1524.  
  1525.         Manual Dialing: 'm'
  1526.  
  1527.  
  1528.         You can also use auto-dialing to call phone numbers not stored in 
  1529.         the Dialing Directory. From the main Dialing Directory prompt, 
  1530.         type 'm' <Enter>. The current Comm params will be displayed & you 
  1531.         will be given options to use or alter them. (Note: if the current 
  1532.         params in effect are different from the default, & if you select 
  1533.         default, call the number and then go to Redial (Alt-Q), you will see 
  1534.         the current params listed on the screen, but the call will be made 
  1535.         with the default params.) A prompt will then ask for the phone number 
  1536.         to be dialed. Type the phone number and press <Enter>, and the number 
  1537.         will be dialed automatically.
  1538.  
  1539.  
  1540.         As in the Dialing Directory, preceding the phone number with '+' 
  1541.  
  1542.         or '-' will route the call through one of the supplemental long 
  1543.  
  1544.         distance service numbers (if they have been stored in the Directory.)
  1545.  
  1546.  
  1547.         Expanding and Contracting the DIAL DIRECTORY:
  1548.  
  1549.         The directory default size is 4 pages of 15 entries each, totaling 
  1550.         60 entries.  You may alter this size by selecting the 'S' option.  
  1551.         You will be shown the current number of pages and asked for the new 
  1552.         number of pages.  The maximum directory size is 66 pages of 15 
  1553.         entries each or 990 entries.  The minimum is 4 pages. You cannot 
  1554.         change the number of entries per page.
  1555.  
  1556.         NOTE: If you have entries on a page and you elect to contract the 
  1557.         directory, such that that page is eliminated, then the entries on it 
  1558.         will be lost.  You may not select a smaller size than 4 pages. The 
  1559.         number of pages selected in all cases -- expand or contract -- begin 
  1560.         with page 1.
  1561.  
  1562.                     ----------------------------------------
  1563.  
  1564.  
  1565.         Redialing: Alt-Q
  1566.  
  1567.         If you have a Hayes Smartmodem<tm>, the last phone number you 
  1568.         have dialed can be redialed at any time by pressing Alt-Q, which 
  1569.         calls into effect the Redial routine.
  1570.  
  1571.         The routine will display the time the Redial routine was started,
  1572.         the time the current "pass" started, elapsed time, and the number of 
  1573.         the pass, and the no. of seconds into the pass.  The redial delay 
  1574.         period, or cycle length which was set in the Default table, can be 
  1575.         changed for a redial session by pressing ' ] ' when in Redial.  This 
  1576.         allows faster cycling when telephone conditions permit. (This delay 
  1577.         does not affect the internal modem delay in register S7.)  You are 
  1578.         also given 3 options for temporarily altering the delay, which thus 
  1579.         allow even faster recycling, increasing your chances of connecting.
  1580.  
  1581.  
  1582.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.                   --- PC-TALK III User's Guide (Rev. 7) ---             38A
  1589.  
  1590.  
  1591.  
  1592.         When a connection is made, the program will sound a 2-note alarm 
  1593.         twice, and show with whom you are connected.  If a macro is in 
  1594.         progress, execution will continue, otherwise you are returned to the 
  1595.         terminal mode. You can exit from the auto-redial routine at any time 
  1596.         before a connection is made by pressing the space bar.  You can cause 
  1597.         an immediate recycle at anytime during a pass by pressing 'R'. 
  1598.  
  1599.         You may go directly to Redial from normal dial.  The first pass 
  1600.         will automatically abort the in-progress normal dial sequence.   
  1601.         Pressing the space bar will not hangup if connect has occurred. 
  1602.         Pressing Alt-D anytime in the redial sequence takes you to the  
  1603.         Dialing Directory.
  1604.  
  1605.         You can adapt the Redial routine for longer or shorter delays, or 
  1606.         for other modems with auto-dialing features, from within the 
  1607.         Default routine described below.
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.                   --- PC-TALK III User's Guide (Rev. 7) ---              44
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.                          === Parameters and Defaults ===
  1662.  
  1663.  
  1664.  
  1665.         Communications Parameters: Alt-P
  1666.  
  1667.  
  1668.         It is not necessary that you understand communications protocols 
  1669.  
  1670.         to use PC-TALK, but you might find it helpful to read the brief 
  1671.  
  1672.         explanation of communications parameters included as Appendix A 
  1673.  
  1674.         at the end of this documentation.
  1675.  
  1676.  
  1677.         Pressing Alt-P at any time while the program is running will call 
  1678.  
  1679.         up a menu which allows you to set the communications parameters 
  1680.  
  1681.         to one of four options.
  1682.  
  1683.  
  1684.         The most common parameters for personal computer communications 
  1685.  
  1686.         is 1200 baud, even parity, 7 data bits, and 1 stop bit (option 
  1687.  
  1688.         3).  These parameters transmit text files as ASCII characters.
  1689.  
  1690.  
  1691.         To transmit binary data, you should communicate with 8 data bits 
  1692.  
  1693.         (option 4). This option is also used to transmit "high-bit" 
  1694.  
  1695.         encoded files (such as Wordstar<tm> formatted text files).
  1696.  
  1697.  
  1698.         Options 1 and 2 will transmit text and binary files at 300 baud, 
  1699.         while Options 5,6 = 2400 baud, 7,8 = 4800 baud, and 9,10 = 9600.
  1700.  
  1701.  
  1702.         Option "F" of the Communications Parameters menu permits you to 
  1703.  
  1704.         reset the parameters to those specified as the program Defaults 
  1705.  
  1706.         (see below).
  1707.  
  1708.  
  1709.         If you want to specify parameters other than one of the four 
  1710.  
  1711.         options, you should first press 'x' to exit to the terminal mode 
  1712.  
  1713.  
  1714.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.                   --- PC-TALK III User's Guide (Rev. 7) ---              45
  1721.  
  1722.  
  1723.         and then invoke the Default routine by pressing Alt-F.
  1724.  
  1725.  
  1726.         **Applications and Advanced Features:
  1727.  
  1728.         If either you or the remote computer is receiving unintelligible 
  1729.  
  1730.         information on the screen, you are probably using different 
  1731.  
  1732.         communications parameters.  Sometimes you will be able to change 
  1733.  
  1734.         the parameters while communications are in progress, but it may 
  1735.  
  1736.         cause a break in communications, depending on the system you are 
  1737.  
  1738.         calling and the modems in use.
  1739.  
  1740.  
  1741.         If you specify 8 data bits, (even-numbered options), your modem 
  1742.  
  1743.         might not give intelligible result codes. Also, if you transmit 
  1744.  
  1745.         text files using the even-numbered options, as is required to 
  1746.  
  1747.         transmit re-formattable Wordstar<tm> files, your screen may 
  1748.  
  1749.         display unintelligible characters during transmission. The file 
  1750.  
  1751.         is being transmitted accurately, however.
  1752.  
  1753.                   ---------------------------------------------
  1754.  
  1755.  
  1756.  
  1757.         Program Defaults: Alt-F
  1758.  
  1759.  
  1760.         The "defaults" of a program are those values that the program 
  1761.  
  1762.         assumes every time it is started.  PC-TALK makes a number of such 
  1763.  
  1764.         assumptions, which can be changed at any time while the program 
  1765.  
  1766.         is running by pressing Alt-F.
  1767.  
  1768.  
  1769.         When you press Alt-F, the screen will clear and you will see a 
  1770.  
  1771.         list of the present program defaults.  They are as follows:
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.                   --- PC-TALK III User's Guide (Rev. 7) ---              46
  1787.  
  1788.  
  1789.            ===============================================================
  1790.                              PRESENT PROGRAM DEFAULTS
  1791.            ===============================================================
  1792.            Baud Rate       1200           Screendump File  B:DMP.PCT      
  1793.            Parity             N           Redial Delay     28           
  1794.            Data Bits          8           Connect Prompt   CONNECT      
  1795.            Stop Bits          1           Line 25 Help     Y            
  1796.            Echo               N           Foreground       7            
  1797.            Messages           N           Background       0            
  1798.            Strip #1           000         High Inten.      15           
  1799.            Replace #1         0           Print Port       LPT1:        
  1800.            Strip #2           0           Print Init                      
  1801.            Replace #2         0           Print Width      80           
  1802.            Strip #3           0           Comm. Port       COM1:        
  1803.            Replace #3         0           Comm. Init.      ,CS,DS       
  1804.            Pacing p=                      Modem Init.      
  1805.            Logged Drive       B:          Modm Init Cntd   
  1806.            Margin Width       70          Modem De-init.   
  1807.            Macro Dly Time     3.0         Rsvd                                
  1808.            Macro Dly Char     ~           Rsvd                                
  1809.            Macro Separator    |           Rsvd                                
  1810.            C/R Subst.         }           Rsvd                                
  1811.            Snd LF (term'l)    N           Rsvd                                
  1812.            ================================================================
  1813.         
  1814.         
  1815.         An explanation of each follows:
  1816.  
  1817.                Baud rate  300
  1818.                Parity     E
  1819.                Data bits  7
  1820.                Stop bits  1
  1821.  
  1822.  
  1823.         These are the four communications parameters described 
  1824.         previously. The permissible baud rates are 75, 110, 150, 300, 
  1825.         600, 1200, 1800, 2400, 4800, and 9600. Parity may be E(ven), 
  1826.         O(dd), S(pace), M(ark), or N(one). Data bits may be 4, 5, 6, 7, 
  1827.         or 8. Stop bits may be 1 or 2.
  1828.  
  1829.  
  1830.         Note: If you specify 8 data bits, you must specify N parity. Do 
  1831.         not experiment with any of these values unless you have a 
  1832.         specific application.
  1833.  
  1834.  
  1835.                Echo      N
  1836.                Messages  N
  1837.  
  1838.  
  1839.         The default is to have both the Echo and Message functions 
  1840.  
  1841.         inactive at program startup. To have either function be active, 
  1842.  
  1843.         enter 'Y'.
  1844.  
  1845.  
  1846.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                   --- PC-TALK III User's Guide (Rev. 7) ---              47
  1853.  
  1854.  
  1855.         Note that both functions can be controlled by the Alt-E and Alt-M 
  1856.         keys, regardless of how the defaults are set.
  1857.  
  1858.  
  1859.                Strip #1    000
  1860.                Replace #1  0
  1861.                Strip #2    0
  1862.                Replace #2  0
  1863.                Strip #3    0
  1864.                Replace #3  0
  1865.  
  1866.  
  1867.         These defaults provide the opportunity to strip and/or replace 
  1868.         characters as they are received from the remote computer.
  1869.  
  1870.         The "Strip #" values are the ASCII values of the characters 
  1871.         to be stripped or converted and the corresponding "Replace #" 
  1872.         values indicate the ASCII characters to replace them.
  1873.  
  1874.         A 0 (zero) Strip value indicates that no character is to be 
  1875.         stripped or converted. A 0 (zero) Replace value indicates that 
  1876.         the strip character is to be replaced by a null (no character). 
  1877.  
  1878.         HOWEVER, if three 0's are used, as in 'Strip #1' above, then it 
  1879.         means that ASCII 0, also called NUL, is to be stripped.  You may 
  1880.         not use 000 as a replace character.
  1881.  
  1882.         The values listed in this menu are only the default values for 
  1883.         program startup.  Stripping can be put into effect via the 
  1884.         Dialing Directory, as described in detail above. Stripping is an 
  1885.         advanced feature that should not be used without a specific 
  1886.         application in mind.
  1887.  
  1888.  
  1889.              Pacing p=  ''
  1890.  
  1891.  
  1892.         This gives you the opportunity of specifying a default pacing 
  1893.         instruction, as explained previously.  This default is overridden 
  1894.         by whatever pacing instructions may be put into effect through 
  1895.         the Dialing Directory.  The symbol '' indicates a null entry.
  1896.  
  1897.  
  1898.              Logged drive  B:
  1899.              Margin Width  70
  1900.  
  1901.  
  1902.         Both of these default values can be controlled by the Alt-L and 
  1903.         Alt-W commands described previously.
  1904.  
  1905.  
  1906.         Please note that all of the above defaults can be controlled 
  1907.         independently through program commands.  The values listed in the 
  1908.         Default menu represent only the values the program assumes at 
  1909.         startup.
  1910.  
  1911.  
  1912.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                   --- PC-TALK III User's Guide (Rev. 7) ---              48
  1920.  
  1921.  
  1922.         In contrast, the following defaults can be set only from within the 
  1923.         Default menu.
  1924.  
  1925.                Macro Dly Time   3.0
  1926.                Macro Dly Char   ~
  1927.                Macro Separator  |
  1928.  
  1929.         These three defaults are used in making up Macros. The Delay Time is 
  1930.         in seconds and may be any numeric value up to 32,000 seconds.  See 
  1931.         the section in Input Strings and Macros, for a complete discussion.
  1932.                 
  1933.                C/R subst.  }
  1934.  
  1935.         This final default specifies which character is to be used to 
  1936.         indicate carriage returns when defining Function key and Alt key 
  1937.         input strings (see below).  This character may be changed at will 
  1938.         without altering the actual input string.
  1939.  
  1940.  
  1941.                Snd LF (term'l)  N
  1942.  
  1943.         This option if set to 'Y', will cause Line Feed characters (ASCII 
  1944.         010) to be sent whenever a carriage return character (ASCII 013), 
  1945.         is sent when in the terminal mode.  This may be necessary in 
  1946.         communicating with some mainframe computers.  It has no effect 
  1947.         during file transfer routines.
  1948.  
  1949.                Screendump file  B:DMP.PCT
  1950.  
  1951.  
  1952.         This is the specification of the file that is written to when 
  1953.         Alt-S is pressed to activate the Screendump function.
  1954.  
  1955.  
  1956.                Redial delay    28
  1957.  
  1958.  
  1959.         This pertains to the Alt-Q Redial function.  The "Redial 
  1960.         delay" governs the length of time between re-dial attempts (in 
  1961.         seconds).  Note however, that if your modem has 'dial tracking', 
  1962.         that is, can respond to a busy signal, by issuing a return code of 
  1963.         "BUSY", then that will have priority over the Redial Delay time.  
  1964.         See your modem manual.
  1965.  
  1966.                Connect prompt  CONNECT
  1967.  
  1968.         This must be set to the return code your modem issues when a 
  1969.         connect is established.  This is used in several places in the 
  1970.         program.  You may use the 'extended' codes 'CONNECT 1200' etc., 
  1971.         though it generally is not necessary for proper operation of the 
  1972.         program.  Note that it is probably better to use just word than the 
  1973.         extended numerical portion. In developing macros, it is 
  1974.         less constraining to key on the final "T" than on the final "0" in 
  1975.         the extended codes, since "0"'s are often used in the phone number.
  1976.  
  1977.  
  1978.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.                   --- PC-TALK III User's Guide (Rev. 7) ---              49
  1985.  
  1986.  
  1987.                Line 25 help  Y
  1988.  
  1989.  
  1990.         This default governs whether the brief prompt on line 25 of the 
  1991.         screen is displayed.  To turn off the prompt, enter 'N'.
  1992.  
  1993.  
  1994.                Foreground    7
  1995.                Background    0
  1996.                High inten.   15
  1997.  
  1998.  
  1999.         These three values determine how characters are displayed on the 
  2000.         screen.  If you have a color monitor, you can substitute color 
  2001.         values as explained in the IBM BASIC manual.  Be careful that you 
  2002.         don't assign the same value to Foreground and Background!
  2003.  
  2004.                Print port   LPT1:
  2005.                Print init.  ''
  2006.                Print width  80
  2007.  
  2008.  
  2009.  
  2010.         These three values govern the use of the printer.  You can 
  2011.         specify 'LPT2:' as an optional printer port, if that is where 
  2012.         your printer is connected.
  2013.  
  2014.  
  2015.         The "Print init." default permits you to send characters to the 
  2016.         printer for alternate character fonts.  The "Print width" 
  2017.         specifies how many columns per line the printer will handle.
  2018.  
  2019.            For example, to print in condensed type at 132 columns 
  2020.            per line on the IBM Matrix Printer, enter <Ctrl>-O (oh) 
  2021.            as the Print init. value and '132' as the Print width.
  2022.  
  2023.                Comm. port   COM1:
  2024.                Comm. init.  ,CS,DS
  2025.  
  2026.  
  2027.         The first of these defaults permits you to specify 'COM2:' as the 
  2028.         communications port.
  2029.  
  2030.  
  2031.         The second default disables checking of the "Clear to Send" and 
  2032.         "Data Set Ready" signals when the communications port is opened. 
  2033.         This default should not be changed unless you have a specific 
  2034.         application. Consult the IBM BASIC Manual under the OPEN "COM... 
  2035.         statement for details.
  2036.  
  2037.  
  2038.                Modem Init.      (Example:) ATS7=99S8=1
  2039.                Modm Init Cntd.     (")     S10=10S0=0X4
  2040.                Modem De-init.      (")     ATZ
  2041.  
  2042.  
  2043.  
  2044.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.                   --- PC-TALK III User's Guide (Rev. 7) ---              50
  2051.  
  2052.  
  2053.         The first to provide the ability to send the modem an string to 
  2054.         initialize it.  The second entry is simply a continuation of the 
  2055.         first. DO NOT BEGIN THE SECOND ENTRY WITH THE MODEM'S COMMAND 
  2056.         CHARACTERS, "AT" in the case of the Hayes and Courier 2400.  The 
  2057.         examples are merely to illustrate  possible entries.
  2058.  
  2059.  
  2060.         The last five entries marked, 'Rsvd' are reserved for future 
  2061.         expansion.
  2062.  
  2063.  
  2064.  
  2065.         The procedure for entering new default values is simple.  When 
  2066.         you first call up the Default menu, the cursor will be paused 
  2067.         next to the default for the baud rate. You can enter new values 
  2068.         for all the defaults or leave them unchanged as follows:
  2069.  
  2070.  
  2071.         -- If you want to enter a value, type the new value and then 
  2072.  
  2073.            press <Enter>.
  2074.  
  2075.         -- If you want to leave the value unchanged, simply press <Enter>.
  2076.  
  2077.         -- If you want to enter a null (blank) value, type <space> <Enter>.
  2078.  
  2079.  
  2080.         When you do not want to change any more values, type <Esc> <Enter>. 
  2081.         (Pressing the <Esc> key will display a small left arrow on the 
  2082.         screen.)
  2083.  
  2084.  
  2085.         You will then be asked whether the new values you entered are ok.  
  2086.  
  2087.         If you do not respond with 'y', you will exit the Default routine 
  2088.  
  2089.         and all of the old defaults will remain in effect.
  2090.  
  2091.  
  2092.         If you indicate that the new values are ok, you will be asked 
  2093.  
  2094.         whether you want to make the changed default values permanent.  
  2095.  
  2096.         If you respond 'y', your changes will be written to a file called 
  2097.  
  2098.         PC-TALK.DEF.  The new values will be put into effect, and they 
  2099.  
  2100.         will become the new default program values the next time PC-TALK 
  2101.  
  2102.         is run.
  2103.  
  2104.  
  2105.         If you do not want to make the changes permanent, your new values 
  2106.         will be put into effect, but the old values will remain as the 
  2107.  
  2108.  
  2109.  
  2110.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.                   --- PC-TALK III User's Guide  (Rev. 7) ---             52
  2117.  
  2118.  
  2119.                         === Input Strings (Macros) ===
  2120.  
  2121.  
  2122.  
  2123.         The Function Key Directory: Alt-J or Alt-K
  2124.  
  2125.  
  2126.         One of PC-TALK's other powerful features is the Function Key 
  2127.         Directory, which is called up by pressing Alt-K, or Alt-J (to  
  2128.         accommodate users of the KEYNOTE program.)
  2129.  
  2130.         The Function Key Directory permits you to assign permanent 
  2131.  
  2132.         strings of up to 126 characters to the ten Function keys F1 
  2133.  
  2134.         through F10, and to the combinations of Alt-, Shift-, and Ctrl- 
  2135.  
  2136.         F1 through F10.  A total of forty keys can thus be assigned 
  2137.  
  2138.         permanent strings, which can be used to input i.d. numbers, logon 
  2139.  
  2140.         sequences, frequently-used phrases and other text with a single 
  2141.  
  2142.         keystroke.  Also, they may be used to execute selected PC-TALK 
  2143.  
  2144.         commands, initiate calls by accessing the dialing directory, and do 
  2145.  
  2146.         both timed and character pacing, i.e. strings are not sent until a 
  2147.  
  2148.         certain time has elapsed, or until a certain character appears on 
  2149.  
  2150.         your screen. 
  2151.  
  2152.  
  2153.         The information in the Function Key Directory is stored in a file 
  2154.  
  2155.         called PC-TALK.KEY and is loaded every time PC-TALK is run.
  2156.  
  2157.         The first time the Function Key Directory is called up, you will 
  2158.  
  2159.         see that the keys F1 through F10 have no strings assigned to 
  2160.  
  2161.         them.  To program a key (or to revise a previously programmed 
  2162.  
  2163.         key), press 'r' at the first prompt.  You will then be asked to 
  2164.  
  2165.         specify which Function key (1 through 10) you wish to revise.  
  2166.  
  2167.         Type the appropriate number and hit <Enter>.
  2168.  
  2169.  
  2170.         You will then be prompted to enter the string you want to assign
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.                   --- PC-TALK III User's Guide (Rev. 7) ---             54A
  2183.  
  2184.  
  2185.         You can include control characters (ASCII 0 through 31) as part 
  2186.         of the input string.  The program will display these characters 
  2187.         as their highlighted letter equivalents (e.g., an ASCII 12 will 
  2188.         be displayed as a highlighted letter 'L'). 
  2189.  
  2190.         You can change the character used as the carriage return 
  2191.         substitute from the right curly bracket to any other character 
  2192.         from within the Default specification routine.  This carriage 
  2193.         return substitute only affects how the string is specified and 
  2194.         how it is displayed on the screen; the program always stores a 
  2195.         "real" carriage return (ASCII 13).  Thus, you can switch back and 
  2196.         forth using different characters as the substitute.
  2197.          
  2198.  
  2199.         Macro Formats:
  2200.  
  2201.         An Input String or MACRO as we shall call them here can have two 
  2202.         basic formats: 
  2203.  
  2204.         1) A regular line of text which may include all characters in any 
  2205.         sequence from ASCII 1 to 127, except ASCII 124, the vertical bar '|'. 
  2206.         When the '}' is used, it represents a carriage return/line feed 
  2207.         sequence as stated above.
  2208.  
  2209.         2) A formatted macro is one containing one or more '|', which is used 
  2210.         as a special formatting character.  There are 5 Types of sequences, 
  2211.         which we will call segments. The segment type is denoted by the number 
  2212.         1, 2, 3, 4, or 5, which must follow a '|'.  You may freely intermix 
  2213.         segment types within a macro, except that a Type 4 segment may only 
  2214.         follow a Type 3 segment.  The ~ (tilde) will call a 3 second time 
  2215.         delay, when used in the first OR second position, but not both, of a 
  2216.         Type 2 or the first position of a Type 5, as will be explained below. 
  2217.         The contents of each segment is strictly limited as follows:
  2218.  
  2219.          Type 1:  Used for dialing directory entries.  The format is as 
  2220.                   follows: 
  2221.                               |1nnn  or  |1-nnn or |1+nnn         
  2222.  
  2223.                   where the | indicates the beginning of the segment, the 1 
  2224.                   indicates the segment type. You may then enter up to 
  2225.                   four characters, the first one of which must be a + or -
  2226.                   service designator, if applicable.  The next 3 are the 
  2227.                   dial directory entry number, from 1 - 990, (or the 
  2228.                   maximum for which your directory is configured).  Leading 
  2229.                   0's need not be included, but are accepted.
  2230.  
  2231.         Type 2:   Used for Timed and Character pacing, and sending strings of 
  2232.                   data such as test etc. to the other computer. Formats may 
  2233.                   be as follows:
  2234.  
  2235.                               |2:data  or  |2~data  or |2?~data
  2236.                   Where, 
  2237.                     the | and 2 indicate beginning and type number. The next 
  2238.                     character indicates the character to wait-for or to pace 
  2239.                     upon, unless it is a ~, in which case a 3 second delay is 
  2240.  
  2241.  
  2242.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                   --- PC-TALK III User's Guide (Rev. 7) ---              55
  2249.  
  2250.  
  2251.  
  2252.                     produced (timed pacing), before the data string that 
  2253.                     follows is sent.  In the first example the string "data" 
  2254.                     will not be sent until the remote computer has sent a ':'. 
  2255.                     In the third case the string 'data' will not be sent until 
  2256.                     a '?' has been received from the remote computer.  This 
  2257.                     initiates a three second delay, after which, the string 
  2258.                     'data' is sent. (A carriage return indicator (}) need not 
  2259.                     follow the last character of the string, unless you want a 
  2260.                     carriage return/line feed.  TILDES (~) MAY ONLY BE USED IN 
  2261.                     TYPE 2 SEGMENTS & ONLY ONE PER SEGMENT.  IF A SECOND TILDE 
  2262.                     IS USED IT WILL SIMPLY BE CONSIDERED A PART OF THE STRING 
  2263.                     TO BE SENT. (A subcommand is provided to allow extension 
  2264.                     of the time delay if desired, or you may program a series 
  2265.                     of |2~ segments without limit. The Tilde can't be used as 
  2266.                     a Wait-for character.  The 3-sec delay can be changed in 
  2267.                     the Default section (Alt-F).
  2268.  
  2269.         Type 3:     Used for doing commands. The following commands may be 
  2270.                     accessed: Alt- B,C,E,G,H,I,L,N,P,Q,R,T,V,X,Y,Z. Format 
  2271.                     is as follows:
  2272.  
  2273.                               |3Z  or |3C
  2274.  
  2275.                   Where,
  2276.                     The | and 3 indicate start and type number, and the 
  2277.                     CAPITAL letter indicates the commands (upper or lower 
  2278.                     case). Self-completing commands such as Alt-C & Z etc. 
  2279.                     will be fully executed.  Non-self completing commands 
  2280.                     such such as Alt- G, I, L, N, R, T, V, etc. will proceed  
  2281.                     to the first point at which keyboard entry is expected. 
  2282.                     You must then complete the sequence, by 1) entering the 
  2283.                     filename and pressing Enter etc. After the command has 
  2284.                     completed, the rest of the macro will again be in control. 
  2285.                     OR, 2) Programming a Type 4 segment described next.
  2286.  
  2287.         Type 4:   Call a Filename from the Alt-1/0 keys. The format is: 
  2288.  
  2289.                                  |4n
  2290.                   Where,
  2291.                     n = one of the Alt-1/0 keys, e.g. |47 would call the data 
  2292.                     in Alt-7. A Type 4 segment may only follow a Type 3 
  2293.                     segment. n may be only 1 digit, if you use more than one 
  2294.                     digit, only the first will be used and you will then get 
  2295.                     an error msg. if any segments remain. A Type 4 segment is 
  2296.                     only valid for the file commands, Alt-G, I, L, N, R, T, V.
  2297.  
  2298.                     This powerful feature allows you to completely automate 
  2299.                     the xfer of files or viewing of a file. To use this 
  2300.                     feature you must first install a filespec in one or more 
  2301.                     of the Alt-1/0 keys (the Shift-Tab command). Any standard 
  2302.                     DOS 2.0 filespec format is acceptable, except paths. & 
  2303.                     MUST include the PC-TALK extensions =x, =b, =p, etc., if 
  2304.                     you are going to use them. Do not put a <cr> (}) after a
  2305.                     filenmae, it isn't necessary.
  2306.  
  2307.  
  2308.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.                   --- PC-TALK III User's Guide (Rev 7) ---              55A
  2315.  
  2316.  
  2317.  
  2318.             Special Feature:
  2319.  
  2320.             1)    By using the Alt-I command in a Macro, you can call and load 
  2321.                   another Alt-1/0 file that has previously been made either in 
  2322.                   your WP or with the Alt-U command.  Thus, you may chain and 
  2323.                   loop. If an Alt-1/0 file called PC-TALK.ALT exists when 
  2324.                   PC-TALK is booted, it will be automatically loaded.  
  2325.  
  2326.                   If the command line which boots the program, calls an F-Key 
  2327.                   which has a macro that in turn does a |3I|4n, where n is an 
  2328.                   Alt-1/0 key containing the filename of another Alt-1/0 file, 
  2329.                   then that file will be called to replace the one then in 
  2330.                   effect, (in this example, PC-TALK.ALT). 
  2331.  
  2332.  
  2333.             2)    If the Alt-I command is used in a macro (|3I) a Type 4 
  2334.                   command having the format: |4x may be used, where 'x' is a 
  2335.                   letter A-Z, in order to load an ALT file having the name 
  2336.                   PC-TALKx.ALT, where the 'x' is a letter A-Z used in the 
  2337.                   |4x format.
  2338.  
  2339.                   Example: An ALT file called PC-TALKD.ALT can be loaded by 
  2340.                            a macro which includes:
  2341.  
  2342.                                         |3I|4D
  2343.  
  2344.                   Note that NO error checking is done on the Type 3 to make 
  2345.                   sure that it is |3I, so if you try |3G etc. -- you're 
  2346.                   gonna be in big trouble!!!
  2347.  
  2348.  
  2349.         Type 5:   Send a Plain String Immediately.  The format is:
  2350.  
  2351.                                    |5xxxxxxxx
  2352.  
  2353.                     This is the equivalent of an unformatted input string, 
  2354.                     that can be used inside a Macro.  When a Type 5 segment is 
  2355.                     encountered the program immediately sends the characters 
  2356.                     which follow, up to the next |.  You may use the ~ as the 
  2357.                     first character to produce a delay if desired. In this 
  2358.                     respect it is like a Type 2 segment.
  2359.  
  2360.         Error Checking:
  2361.  
  2362.         Each segment is checked for errors in protocol as it is sent, and if 
  2363.         an error in format or type is found, the msg "ABORT: INVAL MACRO TYPE" 
  2364.         is given, followed by the msg., "MACRO TERMINATED".  If you have 
  2365.         chosen a command not allowed or a directory number is not entered 
  2366.         properly, the msg., "INVALID NUMBER OR COMMAND", followed by, 
  2367.         "MACRO TERMINATED" is given. Any error detected terminates the macro. 
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.                   --- PC-TALK III User's Guide (Rev 7) ---              55B
  2381.  
  2382.  
  2383.         NOTE: The Vertical Bar (|) may not be used in any manner other than 
  2384.         indicated above and may not be a part of a data string.  The Tilde 
  2385.         (~), may not be used for character pacing (the wait-for character). 
  2386.  
  2387.           The Tilde may be used in a data string in Type 2 & 5 segments 
  2388.           provided that it is NOT:  
  2389.  
  2390.             In Type 2: a) Used as the first character.  b) Used as the second 
  2391.                           character, if it is used as the first character. 
  2392.  
  2393.             In Type 5: a) Used as the first character.
  2394.  
  2395.         A blank space (ASCII 32) may be used for character pacing, 
  2396.         which will in most cases produce immediate sending of the data string. 
  2397.         It may also of course be a part of the data string in the Type 2 & 5
  2398.         segments. Tildes & blanks are not allowed in Types 1, 3, & 4 segments, 
  2399.         which are restricted to the formats shown above. MACROS CANNOT BE 
  2400.         NESTED i.e. you can't call one from another. An Alt-1/0 key may not 
  2401.         contain a | if it to be called from a macro already running.
  2402.  
  2403.         Note that both the '|' and the '~' characters can be changed in the 
  2404.         Alt-F Defaults routine, as well as the time given by the tilde.
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.                   --- PC-TALK III User's Guide (Rev. 7) ---              56
  2447.  
  2448.  
  2449.  
  2450.         The timing character can be changed in the default file to any 
  2451.         character you wish. It is called F-Key Dly Char: (bottom right).  
  2452.         Pressing ']' during a timing sequence cause another time period to be 
  2453.         added.
  2454.  
  2455.         Pressing ESC will terminate a macro.
  2456.  
  2457.         What happens if you either don't know the prompt to expect or the 
  2458.         expected prompt doesn't appear or is different from what you expected? 
  2459.         Easy, in the first case simply either build in dummy prompts.  In all 
  2460.         cases, when the program is waiting hit '{' and the next segment will 
  2461.         be sent.  IMPORTANT: The '{' will cause only the current segment to be 
  2462.         sent, i.e. up to the next |. 
  2463.  
  2464.         To test a new string, simply hit the F-Key, then type the expected 
  2465.         characters and the string will "play" out. (Modem must be on.)
  2466.  
  2467.  
  2468.         Programmers Note: The program looks at the last 4 characters
  2469.                           printed to the screen for the prompt character.
  2470.  
  2471.         Example 1:    
  2472.  
  2473.           |11|2T~^C|2:777777,777}|2:pass*word}|2!G PCS131}
  2474.  
  2475.  
  2476.         Logs you onto CompuServe and takes to the IBM SIG with one keystroke.
  2477.         Macro dials directory entry #1, waits for 3 sec. after seeing the T 
  2478.         in CONNECT, then sends a control-C, waits for a colon two times, and 
  2479.         the ! the next, sending respectively, i.d., password & GO command.
  2480.  
  2481.  
  2482.         Example 2: (Typical BBS)  Macro located in function key F1.
  2483.  
  2484.          |1-5|20|20~}|2~}|2?Y}|2?FirstName}|2?LastName}|2?pswd}|2?F}|2~|2~
  2485.          |2?D;FILESPEC}|2?~X}|2~|3R|46
  2486.  
  2487.         (Blanks are not allowed as partitions in macros. Blanks in Type 2 & 5
  2488.         strings are ok. Double or Single Quotes have no special meaning in 
  2489.         strings.)
  2490.  
  2491.         ASSUME: Hayes Modem set to echo CONNECT 1200. The number and info for 
  2492.         the BBS is stored in directory entry #5 and that a special service is 
  2493.         to be used, that the tel no. has a 0 in it. A BBS requiring 2 <cr>'s 
  2494.         before commencing. The 1rst question Can Your Term. Disp Lower Case? A 
  2495.         ? being the wait-for character. A download using Xmodem. The FILESPEC 
  2496.         being located in Alt-6.  THEN: When the command line at bootup is 
  2497.         given as PC-TALKC F1, or, when program is already in operation and the 
  2498.         function key F1 is pressed the following will occur.
  2499.  
  2500.         Dials Directory entry #5 using the '-' special service. Passes the 0 
  2501.         in the Tel no. Sees the 0 in CONNECT 1200 & sends delay allowing BBS 
  2502.         to prepare. Sends delay and 1rst <cr>. Sends delay and 2nd <cr>. 
  2503.         Answers the first question Yes, (Can Display Lower Case?). Waits for ? 
  2504.  
  2505.  
  2506.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.                   --- PC-TALK III User's Guide (Rev. 7) ---             56A
  2513.  
  2514.  
  2515.  
  2516.         and sends first name, waits for ? & sends last name. Waits for ? & 
  2517.         sends password. Waits for ? and selects Files section. Waits 2 delay 
  2518.         periods for BBS to cycle menus, one of which may have a ? mark in it 
  2519.         which we need to bypass. Waits for ? & sends D;FILESPEC. Waits for ? 
  2520.         for mode selection, gives delay to allow BBS to cycle & then sends X 
  2521.         (Xmodem), then gives delay to allow BBS to cycle. Then calls for Alt-R 
  2522.         (Recv File). Then gets FILESPEC from Alt-6. Download then proceeds to 
  2523.         automatic completion.
  2524.  
  2525.  
  2526.         Note: If your macro does not play out as you expect, chances are that 
  2527.         your wait-for character is appearing in an unexpected place. The ways 
  2528.         around that are to either provide delay segments or dummy wait for 
  2529.         segments that merely pass the wait-for character without sending 
  2530.         anything.
  2531.  
  2532.  
  2533.         Variable Length Fields:
  2534.  
  2535.         You may insert a "break" in the string, enter whatever you wish from 
  2536.         the keyboard and then, using the '{' Send subcommand, have the rest 
  2537.         of the string continue. Simply enter a wait-for character that you 
  2538.         are not likely to receive, say a little used cntrl code like Cntrl- 
  2539.         (ASCII 31). The program wait for a character which will never come.
  2540.         You may type what you wish (except the {), then type the '{'.
  2541.  
  2542.                   ---------------------------------------------            
  2543.  
  2544.         A new user of the program does not need to have the PC-TALK.KEY 
  2545.         file on his/her disk. If the program does not locate PC-TALK.KEY 
  2546.         on the program disk, it will initialize and create a new blank 
  2547.         Function key file. The same is true for the file PC-TALK.DIR, 
  2548.         which contains the information used by the Dialing Directory.
  2549.  
  2550.                  -----------------------------------------------
  2551.  
  2552.  
  2553.         Temporary Alt Keys: Alt-1 through Alt-0:
  2554.  
  2555.         In addition to the permanent Function key combinations described 
  2556.         above, the ten key combinations Alt-1 through Alt-0 can be used
  2557.         for temporary custom input while communications are in progress.
  2558.  
  2559.  
  2560.         Pressing Shift-TAB during communications will display a prompt on 
  2561.         line 25 of the screen, asking for the key to be used. Type any of 
  2562.         the numbers 1 through 0. (Pacing features also apply.) Originally, 
  2563.         Alt-= was used for this function. This was changed due to 
  2564.         interference with Prokey.
  2565.  
  2566.  
  2567.         You will then be prompted to enter the temporary string for that 
  2568.         Alt key. All keystrokes entered subsequently will input text for 
  2569.         that key, until you press <Enter> (maximum 50 characters).
  2570.  
  2571.  
  2572.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.                   --- PC-TALK III User's Guide (Rev. 7) ---             56B
  2579.  
  2580.  
  2581.         As with the Function key assignments described above, you can use 
  2582.         a right curly bracket '}' to include a carriage return as part of 
  2583.         the temporary string.  Control characters will be displayed as 
  2584.         their highlighted letter equivalents.
  2585.  
  2586.         When a temporary Alt key has been assigned, the program will 
  2587.         display the first seven characters of the programmed input on 
  2588.         line 25 of the screen and return to normal keyboard operation.
  2589.  
  2590.  
  2591.  
  2592.         Once an Alt key 1 through 0 has been assigned, pressing it will 
  2593.         send the assigned string, just as though it had been typed from 
  2594.         the keyboard.  
  2595.  
  2596.         The Alt keys can also be used to input filespecs, and commands for 
  2597.         use with Alt-N.
  2598.  
  2599.  
  2600.         You can change an Alt key assignment at any time by pressing
  2601.         Shift-TAB, followed by the number of the key to be respecified and 
  2602.         the new assignment.
  2603.  
  2604.  
  2605.         If you want to clear a key, press Shift-TAB, the number of the 
  2606.         key, and then type <space> <Enter>.  If no Alt-key assignments 
  2607.         are in effect, the display on line 25 will disappear.
  2608.  
  2609.  
  2610.         **NOTE the difference between these Alt key assignments and the 
  2611.                Function key assignments described above:
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.                   --- PC-TALK III User's Guide (Rev. 7) ---              57
  2645.  
  2646.  
  2647.         The Alt-1/0 keys can be easily reprogrammed during communications 
  2648.  
  2649.         and are displayed on line 25 of the screen.  You may also view the
  2650.  
  2651.         Alt Key Directory at anytime by pressing Alt-A.  This makes them 
  2652.  
  2653.         convenient for holding temporary input strings needed for quick 
  2654.  
  2655.         reference.  However, the Alt-key assignments are not saved when 
  2656.  
  2657.         the program is terminated, unless you save them with Alt-U.
  2658.  
  2659.  
  2660.         To permanently save the temporary Alt-key 1 thru 0 assignments in
  2661.  
  2662.         a file, press Alt-U.  You will be asked for a filename.  It is good 
  2663.  
  2664.         practice to use the extension .ALT for these files.  To recall
  2665.  
  2666.         them from such a file, press Alt-I and give the filename.  If you
  2667.  
  2668.         create a file called PC-TALK.ALT, it will automatically be loaded
  2669.  
  2670.         each time you boot PC-TALK.  To create PC-TALK.ALT, simply program
  2671.  
  2672.         an Alt-1/0 key, press Alt-U and give the filename PC-TALK.ALT.
  2673.  
  2674.  
  2675.         Note, though you may have as many Alt Key files as you wish, only
  2676.  
  2677.         a file called PC-TALK.ALT will be automatically loaded at boot time.
  2678.  
  2679.  
  2680.         Programmers Note:
  2681.  
  2682.           An Alt Key file is an ASCII text file consisting of up to 10 lines
  2683.           of not more than 50 characters each and enclosed in double quotes.
  2684.  
  2685.           Each line must be terminated with a CR/LF. It may if desired be 
  2686.           prepared by a word processor.  Each line represents an Alt key, 
  2687.           beginning at 1. (The numbers 1-10 are not to be included.)
  2688.  
  2689.  
  2690.         The Function key assignments are stored permanently on 
  2691.  
  2692.         disk and reloaded each time PC-TALK is run.  This makes them
  2693.  
  2694.         convenient for storing id numbers and logon sequences.  When 
  2695.  
  2696.         making changes to the Function Keys or Alt Keys, your keystrokes 
  2697.  
  2698.         are not output to the communications channel.
  2699.  
  2700.                   ---------------------------------------------
  2701.  
  2702.  
  2703.  
  2704.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.                   --- PC-TALK III User's Guide (Rev. 7) ---              59
  2711.  
  2712.  
  2713.  
  2714.         Command Summary: Home key
  2715.  
  2716.         An on-screen summary of all the PC-TALK program commands described
  2717.         above can be displayed at any time by hitting the Home key.
  2718.  
  2719.         Split-Screen: Cntrl-Home (Toggle)
  2720.  
  2721.         All keyboard input from you appears on the bottom line of the screen 
  2722.         in place of the message line, while all input from remote computer
  2723.         appears above.  Press ESC to erase the line.  You may divide the 
  2724.         line into any number of sub-lines by terminating each sub-line with 
  2725.         the carriage return substitute character, usually the '}'. Each 
  2726.         time the <cr> is pressed one sub-segment will be sent. To discontinue 
  2727.         the mode press Cntrl-Home again. Alt-C does not erase line 25. Macros 
  2728.         can be sent (F-Keys/Alt-1/0) while in split mode.
  2729.  
  2730.         Select another Subdirectory:   Alt-G
  2731.  
  2732.         Permits selection of subdirectories and the use of path commands, on 
  2733.         the current logged drive only. (<cr> to cancel.)
  2734.  
  2735.         Hangup: Alt-H
  2736.  
  2737.         Causes the modem to disconnect.  When connected, it is necessary 
  2738.         to gain the modem's attention in order to give it commands.  This 
  2739.         process requires a 1 second silent 'guard' time, 3 '+' signs and 
  2740.         another 1 second silent guard time.  The hangup routine looks for 
  2741.         the 'return codes' sent by the modem to signify command execution.  
  2742.         It will try the sequence up to 4 times, in the event there was a 
  2743.         disturbance during the guard times.  The command given is 'ATH0'. 
  2744.         In a normal sequence, you will hear 2 tones, if the attempt is 
  2745.         successful. However, hangup may occur even if the 2 tones are not 
  2746.         heard, be sure to check the CD lite on your modem if failure of the 
  2747.         sequence is indicated.  A failure of the sequence is a perfectly 
  2748.         normal occurrence, most usually caused by characters entering 
  2749.         the buffer during the guard times.... Just try again.
  2750.  
  2751.         Run Silent:  Alt-B
  2752.  
  2753.         This is a toggle command, and causes all audible tones to be silenced, 
  2754.         except in the case of an error event or an invalid or illegal 
  2755.         sequence.
  2756.  
  2757.         Do DOS Commands: Alt-N
  2758.  
  2759.         This is an advanced feature, which allows you to do any DOS command.  
  2760.         Alt-N uses the SHELL command to accomplish this. An explanation of 
  2761.         the SHELL command is beyond the scope of this manual.  A complete 
  2762.         explanation can be found in your DOS manual.  You may run your 
  2763.         favorite word processor, spreadsheet etc. via this feature.  You can 
  2764.         even via the CTTY function, allow your computer to be operated by a 
  2765.         remote computer.  HOWEVER, YOU MUST NOT RUN ANY PROGRAM WHICH 
  2766.         REMAINS RESIDENT AFTER IT TERMINATES. One such routine is the DOS 
  2767.         MODE.COM and this has been locked out for 'normal' use, since using 
  2768.  
  2769.  
  2770.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.                   --- PC-TALK III User's Guide (Rev. 7) ---             59A
  2777.  
  2778.  
  2779.  
  2780.         the MODE command while on-line can dump you.  However, advanced 
  2781.         users can access these by entering 'COMMAND' at the Alt-N prompt.  
  2782.         When you enter COMMAND<cr>, will be dropped into DOS and will see 
  2783.         the DOS prompt appear.  To return to the program, type EXIT<cr>.  In 
  2784.         all other cases, where COMMAND is not used, you will re-enter  
  2785.         PC-TALK after completion of the DOS command or the program you've 
  2786.         called for.
  2787.  
  2788.         Do NOT use quotes around your command. Also, you may not run another 
  2789.         BASIC program, or call BASIC(A).
  2790.  
  2791.         Example:  Do DOS Command:  C:\WS         <--- Will run WordStar
  2792.                   Do DOS Command:  COMMAND CTTY  <--- Provides remote 
  2793.                                                       operation of your 
  2794.                                                       computer by another.
  2795.  
  2796.         Using the Command Line:
  2797.  
  2798.         You may call a macro located in one of the 40 Function key positions 
  2799.         by typing at the DOS prompt, for example A>PC-TALK F1. F = function 
  2800.         key positions from F1-10,  A = Alt-F1/10,  S = Shft-F1/10, and C = 
  2801.         Cntrl-F1/10.   The following are examples of valid formats which 
  2802.         must follow PC-TALK and be separated from it by a space:  
  2803.  
  2804.                          F0  a7  c3  f4  S0  
  2805.  
  2806.         Note: Use 0 wherever 10 is wanted, e.g. f0 = f10.
  2807.  
  2808.  
  2809.         Only 1 macro may be called on the command line, e.g. PC-TALKC F4 C3 
  2810.         is invalid.
  2811.  
  2812.  
  2813.         The command line parameter must consist of ONE of the letters 
  2814.         F,A,S, or C, & followed immediately by one digit.
  2815.  
  2816.         To further reduce keystrokes, you may use these in a batch file 
  2817.         called P.BAT for example, as follows:  Let's also assume you have 
  2818.         ProKey Ver 3.0, which must be disabled. Also that the macro is 
  2819.         located in function key F4, & Drive A: is where PC-TALK resides & is 
  2820.         the current or default drive.
  2821.  
  2822.         The batch file would have the following lines,
  2823.  
  2824.         PK /S+
  2825.         PC-TALKC %1
  2826.         PK /S- 
  2827.  
  2828.         At the DOS A> prompt type:  P F4 and press <cr>.
  2829.  
  2830.         If you want to make a batch file to always do a specific thing 
  2831.         located say in function key Alt-F10. Your batch file might look like 
  2832.         this: (NOTE: Use 0 wherever 10 is wanted.)
  2833.  
  2834.  
  2835.  
  2836.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.                   --- PC-TALK III User's Guide (Rev. 7) ---              60
  2843.  
  2844.  
  2845.  
  2846.         PK /S+
  2847.         PC-TALKC A0
  2848.         PK /S-
  2849.  
  2850.         You would now at the A> prompt type:    P
  2851.  
  2852.         In both illustrations the batch file would first disable ProKey and 
  2853.         then call PC-TALKC, in the first case using the typed parameter F4 & 
  2854.         in the second, using the batch contained parameter A0. Upon exiting 
  2855.         PC-TALKC, the batch file would re-enable ProKey.
  2856.  
  2857.         Clock Display:
  2858.  
  2859.         A continuous time display is given on Line 25 during times when the 
  2860.         'standard msg' line is displayed. Refresh is roughly every 20 
  2861.         seconds.  Note: The update can be disabled by doing Alt-D, then 
  2862.         typing 'y' at the prompt.  Do it again to restore the refresh.  In 
  2863.         any event, the clock is updated, whenever the standard message is 
  2864.         restored to line 25.
  2865.  
  2866.         Toggle Commands:
  2867.  
  2868.         The following keys toggle on/off their respective functions. 
  2869.  
  2870.                     Alt-E  Echo            Alt-M  Messages
  2871.                     
  2872.                     Alt-V  View *          Ctrl-PrtSc  Printout
  2873.  
  2874.                Cntrl-Home  Split-Screen operation   Alt-B  Run Silent
  2875.  
  2876.         * Alt-V will ask for a Specification.  Press <cr> to exit.
  2877.  
  2878.  
  2879.         Inverse Video Switch:
  2880.  
  2881.         For those who do not desire the use of inverse video, a toggle is 
  2882.         provided that converts inverse video to hi-intensity. Do Alt-D,
  2883.         then type 'Z'.  To restore inverse, do the same thing again.
  2884.  
  2885.  
  2886.  
  2887.                  === More Applications and Advanced Features ===
  2888.  
  2889.  
  2890.  
  2891.         Even though this section is described as "advanced," the 
  2892.         following information should be of interest to all users of the 
  2893.         program.
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.                   --- PC-TALK III User's Guide (Rev. 7) ---             60A
  2909.  
  2910.  
  2911.         XON/XOFF: Alt-O
  2912.  
  2913.  
  2914.         PC-TALK supports the sending of XON/XOFF signals to the remote 
  2915.         computer in the event of a communications buffer overflow (see 
  2916.         below), and will trap for XON/XOFF signals sent by the remote 
  2917.         computer during transmission of files. The default XON signal is 
  2918.         ASCII 17; the default XOFF signal is ASCII 19.
  2919.  
  2920.  
  2921.         If the remote computer sends an XOFF signal during transmission 
  2922.         of a file, the symbol "<<XOFF>>" will be displayed highlighted on 
  2923.         the screen until the remote computer sends an "XON" signal, at 
  2924.         which time transmission will resume automatically.  If transmis-
  2925.         sion has been halted, it may be resumed manually by typing Alt-O 
  2926.         (the letter 'oh') at the keyboard.
  2927.  
  2928.  
  2929.  
  2930.         Communications Errors: <<>> and <<OVERFLOW>>
  2931.  
  2932.  
  2933.         PC-TALK will indicate certain types of errors if they occur during 
  2934.         communications.  If there is an ambient signal on the line, the 
  2935.         program will display the symbol '<<>>' in high intensity.  This 
  2936.         stands for Basic Error 57, Device I/O Error.  It says that one or 
  2937.         more of 4 types of errors have occurred, overrun, parity, framing 
  2938.         or a break signal.  In simple language, some incoming data is 
  2939.         unusable.  Communications will not be interrupted in most cases. 
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.                   --- PC-TALK III User's Guide (Rev. 7) ---              61
  2975.  
  2976.  
  2977.         The <<>> should put you on notice that you are sending or 
  2978.  
  2979.         receiving corrupted data.  On a very noisy line, you may see the 
  2980.  
  2981.         symbol repeatedly.  You should disconnect and try for a better 
  2982.  
  2983.         connection.
  2984.  
  2985.  
  2986.         With some modems, including the Hayes Smartmodem<tm>, you may 
  2987.  
  2988.         see the <<>> symbol when communications are first opened.  This 
  2989.  
  2990.         should not be a cause for concern, provided you do not see the 
  2991.  
  2992.         symbol once communications are in progress.
  2993.  
  2994.  
  2995.         PC-TALK opens a communications buffer for receiving data through 
  2996.  
  2997.         the communications port.  In most cases, the program should be 
  2998.  
  2999.         able to process data as fast as it is received.  If the 
  3000.  
  3001.         communications buffer does fill faster than the program can 
  3002.  
  3003.         handle the incoming data, you will see the symbol <<OVERFLOW>> on 
  3004.  
  3005.         the screen.  The program will then try to recover, by sending an 
  3006.  
  3007.         XOFF signal to the remote computer, processing the contents of 
  3008.  
  3009.         the buffer, and then sending an XON signal.  Of course the overflow 
  3010.  
  3011.         condition will not be remedied by this action if the remote computer 
  3012.  
  3013.         doesn't support the XON/XOFF protocol.  The Buffer size is 5120 bytes.
  3014.  
  3015.  
  3016.         If you are trying to perform simultaneous printout at 1200 baud, 
  3017.  
  3018.         your printer will probably not be able to keep up and eventually 
  3019.  
  3020.         the buffer will overflow.  PC-TALK will attempt to recover by 
  3021.  
  3022.         turning off the print feature.
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.                   --- PC-TALK III User's Guide (Rev. 7) ---              63
  3041.  
  3042.  
  3043.         The first time PC-TALK III is run, the program looks for four support 
  3044.  
  3045.         files.  If it does not find them, the files will be created on 
  3046.  
  3047.         the drive containing the program, at the time they are required.
  3048.  
  3049.  
  3050.         PC-TALK.DIR -- The file that stores Dialing Directory information.
  3051.  
  3052.         PC-TALK.KEY -- The file that stores Function Key information.
  3053.  
  3054.         PC-TALK.DEF -- The file that stores Default Menu information.
  3055.  
  3056.         PC-TALK.ALT -- The file that stores data for Alt keys 1 thru 0. 
  3057.                        This file must be created by the user. If it exists
  3058.                        it will be automatically loaded at boot time. It is 
  3059.                        not required.
  3060.  
  3061.    
  3062.        PC-TALKx.ALT -- An Altkey file similar to PC-TALK.ALT, but 
  3063.                        containing a letter A-Z in the 'x' position, which 
  3064.                        enables it to be automatically loaded via a macro 
  3065.                        command of the type |3I|4x.  This file is not 
  3066.                        required.
  3067.  
  3068.  
  3069.  
  3070.                     ----------------------------------------
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.              --- FREEWARE - P.O. Box 862, Tiburon, CA 94920 ---
  3101.  
  3102.  
  3103.